IsStringSupported-Funktion (recapis.h)

Artikel
03/06/2024

Gibt einen Wert zurück, der angibt, ob ein Wort, ein Datum, eine Uhrzeit, eine Zahl oder ein anderer Text, der übergeben wird, im Wörterbuch enthalten ist.

Die Ergebnisse dieses Tests hängen von der Factoid-Einstellung ab.

Syntax

HRESULT IsStringSupported(
  HRECOCONTEXT hrc,
  ULONG        wcString,
  const WCHAR  *pwcString
);

Parameter

hrc

Das Handle für den Erkennungskontext.

wcString

Die Anzahl von pwcString in Unicode (Breitzeichen).

pwcString

Die zu testden Unicode-Zeichen (Breitzeichen).

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg. Diese Funktion gibt auch S_OK zurück, wenn die Erkennung diese Funktion nicht unterstützt.
E_OUTOFMEMORY	Speicher kann nicht zugeordnet werden, um den Vorgang abzuschließen.
S_FALSE	Die Zeichenfolge wird nicht unterstützt.
E_POINTER	Einer der Parameter ist ein ungültiger Zeiger.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG	Ein ungültiges Argument wurde empfangen.

Hinweise

Diese Funktion ist optional.

Die Ergebnisse dieses Tests hängen von der Factoid-Einstellung ab. Wenn die Factoideinstellung beispielsweise auf den Standardwert festgelegt ist, geben "hello", "555-1234" und "19.10.2002" alle S_OK zurück. Wenn das Factoid jedoch auf TELEPHONE festgelegt ist, gibt nur "555-1234" S_OK zurück, die anderen geben S_FALSE zurück. Weitere Informationen zu Factoids finden Sie unter Unterstützte Factoids ab Version 1.

Beachten Sie, dass diese Funktion bei der Rückgabe eines Werts alle in SetTextContext angegebenen Informationen berücksichtigen sollte. Wenn die Erkennung z. B. Aufrufe von SetTextContext ("http:", "") empfängt und ein URL-Factoid, SetFactoid ((!IS_URL)), dann sollte IsStringSupported("www.microsoft.com") S_FALSE zurückgeben, da "//" fehlt.

Das COERCE-Flag hat keine Auswirkungen auf IsStringSupported.

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

Freigeben über