Metodo INamedEntityCollector::Add (structuredquery.h)

Aggiunge una singola entità denominata (potenziale) a questa raccolta INamedEntityCollector , come identificato in un intervallo tokenizzato della stringa di input da analizzare.

Sintassi

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

Parametri

[in] beginSpan

Tipo: ULONG

Inizio dell'intervallo di token complessivo, incluse le virgolette iniziali.

[in] endSpan

Tipo: ULONG

Fine dell'intervallo di token complessivo, incluse le virgolette finali.

[in] beginActual

Tipo: ULONG

Inizio della parte dell'intervallo di token che identifica la potenziale entità denominata.

[in] endActual

Tipo: ULONG

Fine della parte dell'intervallo di token che identifica la potenziale entità denominata.

[in] pType

Tipo: IEntity*

Tipo semantico dell'entità denominata.

[in] pszValue

Tipo: LPCWSTR

Nome dell'entità come stringa.

[in] certainty

Tipo: NAMED_ENTITY_CERTAINTY

Uno dei valori seguenti:

Valore	Informazioni
NEC_LOW	Potrebbe trattarsi di questa entità denominata, ma è consigliabile un'evidenza aggiuntiva.
NEC_MEDIUM	È probabile che questa entità denominata; va bene usarlo.
NEC_HIGH	Quasi certamente è questa entità denominata; dovrebbe essere ok per scartare altre possibilità.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Quando un parser di query analizza una stringa di input in nodi di condizione, il parser richiama un oggetto IConditionGenerator che, a sua volta, richiama INamedEntityCollector::Add per raccogliere le possibili entità denominate nella stringa di input. L'oggetto IConditionGenerator deve chiamare questo metodo per ogni potenziale entità denominata riconosciuta nella stringa di input. Per ogni entità, il generatore di condizioni deve fornire le informazioni seguenti:

• quale parte della stringa di input copre
• tipo semantico dell'entità denominata
• rappresentazione di stringa del valore dell'entità denominata
• il livello di certezza che l'input è veramente l'entità denominata

Se l'entità denominata è stata utilizzata nell'interpretazione della stringa di input, il metodo GenerateForLeaf del generatore di condizioni verrà richiamato con la stringa di valore come uno degli argomenti.

La relazione seguente deve essere mantenuta tra i quattro primi argomenti: beginSpan = beginActual endActual< = endSpan.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2, Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	structuredquery.h
Componente ridistribuibile	Windows Desktop Search (WDS) 3.0