Partager via

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

  • Article

Ajoute une entité nommée unique (potentielle) à cette collection INamedEntityCollector , comme identifié dans une étendue tokenisée de la chaîne d’entrée en cours d’analyse.

Syntaxe

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
);

Paramètres

[in] beginSpan

Type : ULONG

Début de l’étendue globale des jetons, y compris les guillemets de début.

[in] endSpan

Type : ULONG

Fin de l’étendue de jeton globale, y compris les guillemets de fin.

[in] beginActual

Type : ULONG

Début de la partie de l’étendue de jeton qui identifie l’entité nommée potentielle.

[in] endActual

Type : ULONG

Fin de la partie de l’étendue de jeton qui identifie l’entité nommée potentielle.

[in] pType

Type : IEntity*

Type sémantique de l’entité nommée.

[in] pszValue

Type : LPCWSTR

Nom de l’entité sous forme de chaîne.

[in] certainty

Type : NAMED_ENTITY_CERTAINTY

Une des valeurs suivantes :

Valeur Informations
NEC_LOW Il peut s’agir de cette entité nommée, mais des preuves supplémentaires sont recommandées.
NEC_MEDIUM Il s’agit probablement de cette entité nommée ; il est acceptable de l’utiliser.
NEC_HIGH Il s’agit presque certainement de cette entité nommée ; il devrait être acceptable d’ignorer d’autres possibilités.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Lorsqu’un analyseur de requête analyse une chaîne d’entrée en nœuds de condition, l’analyseur appelle un objet IConditionGenerator qui, à son tour, appelle INamedEntityCollector ::Add pour collecter les entités nommées possibles dans la chaîne d’entrée. L’objet IConditionGenerator doit appeler cette méthode pour chaque entité nommée potentielle qu’il reconnaît dans la chaîne d’entrée. Pour chaque entité, le générateur de conditions doit fournir les informations suivantes :

  • la partie de la chaîne d’entrée qu’elle couvre
  • type sémantique de l’entité nommée
  • représentation sous forme de chaîne de la valeur de l’entité nommée
  • le niveau de certitude que l’entrée est vraiment cette entité nommée
Si l’entité nommée a été utilisée dans l’interprétation de la chaîne d’entrée, la méthode GenerateForLeaf du générateur de condition est appelée avec la chaîne de valeur comme argument.

La relation suivante doit être conservée entre les quatre premiers arguments : beginSpan = beginActual endActual<endActual = endSpan.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP avec SP2, Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible Windows
En-tête structuredquery.h
Composant redistribuable Windows Desktop Search (WDS) 3.0