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

Localiza entidades nomeadas de um tipo especificado em uma cadeia de caracteres tokenizada e retorna o valor da entidade e o número de tokens que o valor da entidade ocupa.

Sintaxe

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*

Um ponteiro para um objeto IEntity que identifica o tipo de entidade nomeada a ser localizada.

[in] pszInputString

Tipo: LPCWSTR

Uma cadeia de caracteres de entrada na qual pesquisar palavras-chave de entidade nomeadas.

[in] pTokenCollection

Tipo: ITokenCollection*

Um ponteiro para a tokenização da cadeia de caracteres no parâmetro pszInputString .

[in] cTokensBegin

Tipo: ULONG

A posição baseada em zero de um token no pTokenCollection do qual começar a pesquisar.

[out] pcTokensLength

Tipo: ULONG*

Recebe um ponteiro para o número de tokens cobertos pela entidade nomeada palavra-chave que foi encontrada.

[out] ppszValue

Tipo: LPWSTR*

Recebe um ponteiro para o valor da entidade nomeada que foi encontrada, como uma cadeia de caracteres Unicode. O chamador deve liberar a cadeia de caracteres chamando CoTaskMemFree. Um objeto INamedEntity pode ser obtido chamando o método GetNamedEntity de pEntity e passando a cadeia de caracteres recebida nesse parâmetro.

Retornar valor

Tipo: HRESULT

Retorna S_OK se a sequência de tokens que começa na posição cTokensBegin indicar uma entidade nomeada do tipo especificado (entidade). Se não houver essa sequência de tokens, retornará S_FALSE.

Comentários

O método localiza apenas entidades nomeadas criadas com palavras-chave no esquema, não entidades nomeadas reconhecidas por um objeto IConditionGenerator .

Requisitos