INamedEntityCollector::Add-Methode (structuredquery.h)

  • Artikel

Fügt dieser INamedEntityCollector-Auflistung eine einzelne (potenzielle) benannte Entität hinzu, die in einer tokenisierten Spanne der zu analysierenden Eingabezeichenfolge identifiziert wird.

Syntax

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

Parameter

[in] beginSpan

Typ: ULONG

Der Anfang der gesamten Tokenspanne, einschließlich aller führenden Anführungszeichen.

[in] endSpan

Typ: ULONG

Das Ende der gesamten Tokenspanne, einschließlich aller nachfolgenden Anführungszeichen.

[in] beginActual

Typ: ULONG

Der Anfang des Teils der Tokenspanne, der die potenzielle benannte Entität identifiziert.

[in] endActual

Typ: ULONG

Das Ende des Teils der Tokenspanne, der die potenzielle benannte Entität identifiziert.

[in] pType

Typ: IEntity*

Der semantische Typ der benannten Entität.

[in] pszValue

Typ: LPCWSTR

Der Name der Entität als Zeichenfolge.

[in] certainty

Typ: NAMED_ENTITY_CERTAINTY

Einer der folgenden Werte:

Wert Informationen
NEC_LOW Es könnte sich um diese benannte Entität handeln, aber zusätzliche Beweise sind ratsam.
NEC_MEDIUM Es ist wahrscheinlich diese benannte Entität; es ist in Ordnung, es zu verwenden.
NEC_HIGH Es ist mit ziemlicher Sicherheit diese benannte Entität; Es sollte in Ordnung sein, andere Möglichkeiten zu verwerfen.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn ein Abfrageparser eine Eingabezeichenfolge in Bedingungsknoten analysiert, ruft der Parser ein IConditionGenerator-Objekt auf, das wiederum INamedEntityCollector::Add aufruft , um mögliche benannte Entitäten in der Eingabezeichenfolge zu sammeln. Das IConditionGenerator-Objekt muss diese Methode für jede potenzielle benannte Entität aufrufen, die es in der Eingabezeichenfolge erkennt. Für jede Entität muss der Bedingungsgenerator die folgenden Informationen bereitstellen:

  • Welcher Teil der Eingabezeichenfolge abgedeckt ist
  • der semantische Typ der benannten Entität
  • Eine Zeichenfolgendarstellung des Werts der benannten Entität
  • das Maß an Sicherheit, dass die Eingabe tatsächlich die benannte Entität ist
Wenn die benannte Entität bei der Interpretation der Eingabezeichenfolge verwendet wurde, wird die GenerateForLeaf-Methode des Bedingungsgenerators mit der Wertzeichenfolge als eines der Argumente aufgerufen.

Die folgende Beziehung muss zwischen den vier ersten Argumenten beibehalten werden: beginSpan = beginActual<endActual = endSpan.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP mit SP2, Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile structuredquery.h
Verteilbare Komponente Windows Desktop Search (WDS) 3.0