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

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:

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

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

Requisitos