IsStringSupported-Funktion (recapis.h)

  • Artikel

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