IConditionGenerator::RecognizeNamedEntities-Methode (structuredquery.h)

Artikel
08/26/2023

Identifiziert benannte Entitäten in einer Eingabezeichenfolge und erstellt eine Auflistung, die sie enthält. Der Wert jeder benannten Entität wird als Zeichenfolge ausgedrückt, die dann von IConditionGenerator::GenerateForLeaf verwendet wird. Die Zeichenfolge kann beliebige Daten enthalten und in einem beliebigen Format vorliegen, da sie nicht von anderen Komponenten untersucht wird.

Syntax

HRESULT RecognizeNamedEntities(
  [in]      LPCWSTR               pszInputString,
  [in]      LCID                  lcidUserLocale,
  [in]      ITokenCollection      *pTokenCollection,
  [in, out] INamedEntityCollector *pNamedEntities
);

Parameter

[in] pszInputString

Typ: LPCWSTR

Die zu analysierende Eingabezeichenfolge.

[in] lcidUserLocale

Typ: LCID

Die LCID, für die benannte Entitäten erkannt werden sollen.

[in] pTokenCollection

Typ: ITokenCollection*

Ein Zeiger auf ein ITokenCollection-Objekt , das angibt, wie die Eingabezeichenfolge tokenisiert wurde.

[in, out] pNamedEntities

Typ: INamedEntityCollector*

Enthält bei der Eingabe einen INamedEntityCollector oder NULL. Enthält bei der Rückgabe eine INamedEntityCollector-Auflistung der benannten Entitäten.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Bei einer Eingabezeichenfolge, einem Benutzergebietsschema (in der Regel dem Standardgebietsschema des Benutzers) und einer Tokenisierung der Eingabezeichenfolge sollte die IConditionGenerator::RecognizeNamedEntities-Methode in der Lage sein, alle benannten Entitäten in dieser Eingabezeichenfolge zu identifizieren und dann jede Entität der Auflistung der benannten Entität hinzuzufügen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	structuredquery.h