Freigeben über


IsStringSupported-Funktion (recapis.h)

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
);

Die Parameter

hrc

Das Handle für den Erkennungskontext.

wcString

Die Anzahl in Unicode-Zeichen (breit) von pwcString.

pwcString

Die zu testden Unicode-Zeichen (breit).

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode Description
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
Ein nicht angegebener Fehler ist aufgetreten.
E_INVALIDARG
Ein ungültiges Argument wurde empfangen.

Bemerkungen

Diese Funktion ist optional.

Die Ergebnisse dieses Tests hängen von der Factoid-Einstellung ab. Wenn beispielsweise die Factoid-Einstellung auf Standard festgelegt ist, geben "hello","555-1234" und "10/19/2002" alle S_OK zurück. Wenn das Factoid jedoch auf TELEFON festgelegt ist, gibt nur "555-1234" S_OK zurück, die anderen geben S_FALSE zurück. Weitere Informationen zu Factoids finden Sie unter Supported Factoids von 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 empfängt, sollte SetFactoid ((!IS_URL)) dann IsStringSupported("www.microsoft.com") S_FALSE zurückgeben, da "//" fehlt.

Das COERCE-Flag hat keine Auswirkungen auf IsStringSupported.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP Tablet PC Edition [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server Nicht unterstützt
Zielplattform Fenster
Header recapis.h
Library inkobjcore.lib
DLL inkobjcore.dll