Méthode IConditionGenerator::RecognizeNamedEntities (structuredquery.h)

Article
08/26/2023

Identifie les entités nommées dans une chaîne d’entrée et crée une collection qui les contient. La valeur de chaque entité nommée est exprimée sous la forme d’une chaîne, qui est ensuite utilisée par IConditionGenerator::GenerateForLeaf. La chaîne peut contenir des données et être dans n’importe quel format, car elle n’est examinée par aucun autre composant.

Syntaxe

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

Paramètres

[in] pszInputString

Type : LPCWSTR

Chaîne d’entrée à analyser.

[in] lcidUserLocale

Type : LCID

LCID par rapport auquel les entités nommées doivent être reconnues.

[in] pTokenCollection

Type : ITokenCollection*

Pointeur vers un objet ITokenCollection qui indique comment la chaîne d’entrée a été tokenisée.

[in, out] pNamedEntities

Type : INamedEntityCollector*

Lors de l’entrée, contient un INamedEntityCollector ou NULL. Au retour, contient une collection INamedEntityCollector des entités nommées.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Étant donné une chaîne d’entrée, des paramètres régionaux utilisateur (généralement les paramètres régionaux par défaut de l’utilisateur) et une tokenisation de la chaîne d’entrée, la méthode IConditionGenerator::RecognizeNamedEntities doit être en mesure d’identifier toutes les entités nommées dans cette chaîne d’entrée, puis d’ajouter chaque entité à la collection d’entités nommées.

Configuration requise


Client minimal pris en charge	Windows XP avec SP2, Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	structuredquery.h