SetFactoid-Funktion (recapis.h)

Artikel
03/04/2024

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

Freigeben über