Método IConditionGenerator::RecognizeNamedEntities (structuredquery.h)
Identifica entidades nomeadas em uma cadeia de caracteres de entrada e cria uma coleção que as contém. O valor de cada entidade nomeada é expresso como uma cadeia de caracteres, que é usada por IConditionGenerator::GenerateForLeaf. A cadeia de caracteres pode conter quaisquer dados e estar em qualquer formato, pois não é examinada por nenhum outro componente.
Sintaxe
HRESULT RecognizeNamedEntities(
[in] LPCWSTR pszInputString,
[in] LCID lcidUserLocale,
[in] ITokenCollection *pTokenCollection,
[in, out] INamedEntityCollector *pNamedEntities
);
Parâmetros
[in] pszInputString
Tipo: LPCWSTR
A cadeia de caracteres de entrada a ser analisada.
[in] lcidUserLocale
Tipo: LCID
O LCID no qual as entidades nomeadas devem ser reconhecidas.
[in] pTokenCollection
Tipo: ITokenCollection*
Um ponteiro para um objeto ITokenCollection que indica como a cadeia de caracteres de entrada foi tokenizada.
[in, out] pNamedEntities
Tipo: INamedEntityCollector*
Na entrada, contém um INamedEntityCollector ou NULL. No retorno, contém uma coleção INamedEntityCollector das entidades nomeadas.
Valor retornado
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Dada uma cadeia de caracteres de entrada, uma localidade de usuário (normalmente a localidade padrão do usuário) e uma tokenização da cadeia de caracteres de entrada, o método IConditionGenerator::RecognizeNamedEntities deve ser capaz de identificar quaisquer entidades nomeadas nessa cadeia de caracteres de entrada e, em seguida, adicionar cada entidade à coleção de entidade nomeada.
Requisitos
| Cliente mínimo com suporte | Windows XP com SP2, Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 com SP1 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | structuredquery.h |
Confira também
Referência