ISchemaProvider::LookupAuthoredNamedEntity-Methode (structuredquery.h)

Artikel
08/26/2023

Sucht benannte Entitäten eines angegebenen Typs in einer tokenisierten Zeichenfolge und gibt den Wert der Entität und die Anzahl der Token zurück, die der Entitätswert belegt.

Syntax

HRESULT LookupAuthoredNamedEntity(
  [in]  IEntity          *pEntity,
  [in]  LPCWSTR          pszInputString,
  [in]  ITokenCollection *pTokenCollection,
  [in]  ULONG            cTokensBegin,
  [out] ULONG            *pcTokensLength,
  [out] LPWSTR           *ppszValue
);

Parameter

[in] pEntity

Typ: IEntity*

Ein Zeiger auf ein IEntity-Objekt , das den Typ der benannten Entität identifiziert, die gesucht werden soll.

[in] pszInputString

Typ: LPCWSTR

Eine Eingabezeichenfolge, in der nach schlüsselwörtern benannten Entitäten gesucht werden soll.

[in] pTokenCollection

Typ: ITokenCollection*

Ein Zeiger auf die Tokenisierung der Zeichenfolge im pszInputString-Parameter .

[in] cTokensBegin

Typ: ULONG

Die nullbasierte Position eines Tokens in der pTokenCollection , von der aus mit der Suche begonnen werden soll.

[out] pcTokensLength

Typ: ULONG*

Empfängt einen Zeiger auf die Anzahl von Token, die von der benannten Entität Schlüsselwort (keyword) abgedeckt werden, die gefunden wurde.

[out] ppszValue

Typ: LPWSTR*

Empfängt einen Zeiger auf den Wert der benannten Entität, die gefunden wurde, als Unicode-Zeichenfolge. Der Aufrufer muss die Zeichenfolge durch Aufrufen von CoTaskMemFree freigeben. Ein INamedEntity-Objekt kann abgerufen werden, indem die GetNamedEntity-Methode von pEntity aufgerufen und die in diesem Parameter empfangene Zeichenfolge übergeben wird.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn die Tokensequenz ab Position cTokensBegin eine benannte Entität des angegebenen (Entitätstyps) angibt. Wenn keine solche Tokensequenz vorhanden ist, wird S_FALSE zurückgegeben.

Hinweise

Die -Methode findet nur benannte Entitäten, die mit Schlüsselwörtern im Schema erstellt wurden, nicht nach benannten Entitäten, die von einem IConditionGenerator-Objekt erkannt werden.

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

Freigeben über