SetFactoid-Funktion (recapis.h)

  • Artikel

Gibt das Factoid an, das eine Erkennung verwendet, um die Suche nach dem Ergebnis einzuschränken.

Sie geben ein Factoid an, wenn ein Eingabefeld einen bekannten Typ aufweist, z. B. wenn das Eingabefeld ein Datum enthält. Sie rufen diese Funktion auf, bevor Sie die Freihandeingabe zum ersten Mal verarbeiten. Rufen Sie daher die SetFactoid-Funktion auf, bevor Sie die Process-Funktion aufrufen.

Syntax

HRESULT SetFactoid(
  HRECOCONTEXT hrc,
  ULONG        cwcFactoid,
  const WCHAR  *pwcFactoid
);

Parameter

hrc

Handle für den Erkennungskontext.

cwcFactoid

Anzahl der Zeichen in pwcFactoid.

pwcFactoid

Gibt das Factoid an, das für den Erkennungskontext verwendet werden soll. Die Zeichenfolge ist nicht NULL-beendet.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
TPC_E_INVALID_PROPERTY
 Das angegebene Factoid wird nicht unterstützt.
TPC_E_OUT_OF_ORDER_CALL
 Sie müssen die SetFactoid-Funktion aufrufen, bevor Sie die Process-Funktion aufrufen.
E_POINTER
 Der Kontext ist ungültig, oder einer der Parameter ist ein ungültiger Zeiger.
E_NOTIMPL
 Die Erkennung unterstützt diese Funktion nicht.
E_OUTOFMEMORY
 Speicher kann nicht zugeordnet werden, um den Vorgang abzuschließen.
E_FAIL
 Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG
 Der Kontext enthält einen ungültigen Wert.

Hinweise

Eine Liste der Factoids, die im cwcFactoid-Parameter übergeben werden können, finden Sie unter Unterstützte Factoids ab Version 1. Das in diesem Thema aufgeführte DEFAULT-Factoid ist kein gültiger Wert, der an SetFactoid übergeben werden soll. Die Plattform-API des Tablet-PCs konvertiert default intern in NULL , bevor die SetFactoid-Funktion aufgerufen wird.

Es wird empfohlen, die Länge der factoid-Zeichenfolge auf maximal 32768 Zeichen zu beschränken.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP Tablet PC Edition [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile recapis.h
DLL inkobjcore.dll

Weitere Informationen

SetFlags-Funktion