Método ISchemaProvider::LookupAuthoredNamedEntity (structuredquery.h)

Busca entidades con nombre de un tipo especificado en una cadena tokenizada y devuelve el valor de la entidad y el número de tokens que ocupa el valor de entidad.

Sintaxis

HRESULT LookupAuthoredNamedEntity(
  [in]  IEntity          *pEntity,
  [in]  LPCWSTR          pszInputString,
  [in]  ITokenCollection *pTokenCollection,
  [in]  ULONG            cTokensBegin,
  [out] ULONG            *pcTokensLength,
  [out] LPWSTR           *ppszValue
);

Parámetros

[in] pEntity

Tipo: IEntity*

Puntero a un objeto IEntity que identifica el tipo de entidad con nombre que se va a buscar.

[in] pszInputString

Tipo: LPCWSTR

Cadena de entrada en la que se van a buscar palabras clave de entidad con nombre.

[in] pTokenCollection

Tipo: ITokenCollection*

Puntero a la tokenización de la cadena en el parámetro pszInputString .

[in] cTokensBegin

Tipo: ULONG

Posición de base cero de un token en pTokenCollection desde la que empezar a buscar.

[out] pcTokensLength

Tipo: ULONG*

Recibe un puntero al número de tokens cubiertos por la palabra clave de entidad con nombre que se encontró.

[out] ppszValue

Tipo: LPWSTR*

Recibe un puntero al valor de la entidad con nombre que se encontró, como una cadena Unicode. El llamador debe liberar la cadena llamando a CoTaskMemFree. Se puede obtener un objeto INamedEntity llamando al método GetNamedEntity de pEntity y pasando la cadena recibida en este parámetro.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si la secuencia de tokens comienza en la posición cTokensBegin denota una entidad con nombre del tipo especificado (entidad). Si no hay ninguna secuencia de tokens, devuelve S_FALSE.

Comentarios

El método solo busca entidades con nombre creadas con palabras clave en el esquema, no entidades con nombre reconocidas por un objeto IConditionGenerator .

Requisitos

Requisito	Value
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
Redistribuible	Búsqueda de escritorio de Windows (WDS) 3.0