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

Artículo
03/15/2023

Identifica entidades con nombre en una cadena de entrada y crea una colección que los contiene. El valor de cada entidad con nombre se expresa como una cadena, que después usa IConditionGenerator::GenerateForLeaf. La cadena puede contener cualquier dato y estar en cualquier formato, ya que ningún otro componente lo examina.

Sintaxis

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

Parámetros

[in] pszInputString

Tipo: LPCWSTR

Cadena de entrada que se va a analizar.

[in] lcidUserLocale

Tipo: LCID

LCID con el que se deben reconocer las entidades con nombre.

[in] pTokenCollection

Tipo: ITokenCollection*

Puntero a un objeto ITokenCollection que indica cómo se ha tokenizado la cadena de entrada.

[in, out] pNamedEntities

Tipo: INamedEntityCollector*

En la entrada, contiene un INamedEntityCollector o NULL. En la devolución, contiene una colección INamedEntityCollector de las entidades con nombre.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Dada una cadena de entrada, una configuración regional de usuario (normalmente la configuración regional predeterminada del usuario) y una tokenización de la cadena de entrada, el método IConditionGenerator::RecognizeNamedEntities debe ser capaz de identificar las entidades con nombre de esa cadena de entrada y, a continuación, agregar cada entidad a la colección de entidades con nombre.

Requisitos


Cliente mínimo compatible	Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 con SP1 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	structuredquery.h