Compartir a través de

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

  • Artículo

Agrega una única entidad con nombre (potencial) a esta colección INamedEntityCollector , tal como se identifica en un intervalo tokenizado de la cadena de entrada que se analiza.

Sintaxis

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

El principio del intervalo de tokens general, incluidas las comillas iniciales.

[in] endSpan

Tipo: ULONG

El final del intervalo de tokens general, incluidas las comillas finales.

[in] beginActual

Tipo: ULONG

El principio de la parte del intervalo de tokens que identifica la entidad con nombre potencial.

[in] endActual

Tipo: ULONG

Final de la parte del intervalo de tokens que identifica la entidad con nombre potencial.

[in] pType

Tipo: IEntity*

Tipo semántico de la entidad con nombre.

[in] pszValue

Tipo: LPCWSTR

Nombre de la entidad como una cadena.

[in] certainty

Tipo: NAMED_ENTITY_CERTAINTY

Uno de los siguientes valores:

Valor Información de
NEC_LOW Podría ser esta entidad con nombre, pero se recomienda evidencia adicional.
NEC_MEDIUM Es probable que esta entidad con nombre; está bien usarlo.
NEC_HIGH Casi seguramente es esta entidad con nombre; debería estar bien descartar otras posibilidades.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Cuando un analizador de consultas analiza una cadena de entrada en nodos de condición, el analizador invoca un objeto IConditionGenerator que, a su vez, invoca A INamedEntityCollector::Add para recopilar posibles entidades con nombre en la cadena de entrada. El objeto IConditionGenerator debe llamar a este método para cada entidad con nombre potencial que reconoce en la cadena de entrada. Para cada entidad, el generador de condiciones debe proporcionar la siguiente información:

  • qué parte de la cadena de entrada abarca
  • el tipo semántico de la entidad con nombre
  • representación de cadena del valor de la entidad con nombre
  • el nivel de certeza de que la entrada es realmente esa entidad con nombre
Si la entidad con nombre se usó en la interpretación de la cadena de entrada, el método GenerateForLeaf del generador de condiciones se invocará con la cadena de valor como uno de los argumentos.

La siguiente relación debe mantenerse entre los cuatro primeros argumentos: beginSpan = beginActual endActual< = endSpan.

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 Windows Desktop Search (WDS) 3.0