Compartilhar via

Método INamedEntityCollector::Add (structuredquery.h)

  • Artigo

Adiciona uma única (potencial) entidade nomeada a essa coleção INamedEntityCollector , conforme identificado em um intervalo tokenizado da cadeia de caracteres de entrada que está sendo analisada.

Sintaxe

HRESULT Add(
  [in] ULONG                  beginSpan,
  [in] ULONG                  endSpan,
  [in] ULONG                  beginActual,
  [in] ULONG                  endActual,
  [in] IEntity                *pType,
  [in] LPCWSTR                pszValue,
  [in] NAMED_ENTITY_CERTAINTY certainty
);

Parâmetros

[in] beginSpan

Tipo: ULONG

O início do intervalo geral do token, incluindo as principais aspas.

[in] endSpan

Tipo: ULONG

O final do intervalo geral do token, incluindo as aspas à direita.

[in] beginActual

Tipo: ULONG

O início da parte do intervalo de token que identifica a entidade nomeada potencial.

[in] endActual

Tipo: ULONG

O final da parte do intervalo de token que identifica a entidade nomeada potencial.

[in] pType

Tipo: IEntity*

O tipo semântico da entidade nomeada.

[in] pszValue

Tipo: LPCWSTR

O nome da entidade como uma cadeia de caracteres.

[in] certainty

Tipo: NAMED_ENTITY_CERTAINTY

Um dos seguintes valores:

Valor Informações do
NEC_LOW Pode ser essa entidade nomeada, mas evidências adicionais são aconselháveis.
NEC_MEDIUM É provável que essa entidade nomeada; não há problema em usá-lo.
NEC_HIGH É quase certamente esta entidade nomeada; não há problema em descartar outras possibilidades.

Retornar valor

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

Quando um analisador de consulta analisa uma cadeia de caracteres de entrada em nós de condição, o analisador invoca um objeto IConditionGenerator que, por sua vez, invoca INamedEntityCollector::Add para coletar possíveis entidades nomeadas na cadeia de caracteres de entrada. O objeto IConditionGenerator deve chamar esse método para cada entidade nomeada potencial que ele reconhece na cadeia de caracteres de entrada. Para cada entidade, o gerador de condição deve fornecer as seguintes informações:

  • qual parte da cadeia de caracteres de entrada abrange
  • o tipo semântico da entidade nomeada
  • uma representação de cadeia de caracteres do valor da entidade nomeada
  • o nível de certeza de que a entrada realmente é aquela entidade nomeada
Se a entidade nomeada tiver sido usada na interpretação da cadeia de caracteres de entrada, o método GenerateForLeaf do gerador de condição será invocado com a cadeia de caracteres de valor como um dos argumentos.

A seguinte relação deve ser mantida entre os quatro primeiros argumentos: beginSpan = beginActual<endActual = endSpan.

Requisitos

Requisito Valor
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
Redistribuível Pesquisa da Área de Trabalho do Windows (WDS) 3.0