Metodo ISchemaProvider::LookupAuthoredNamedEntity (structuredquery.h)

Trova le entità denominate di un tipo specificato in una stringa con token e restituisce il valore dell'entità e il numero di token occupati dal valore dell'entità.

Sintassi

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

Parametri

[in] pEntity

Tipo: IEntity*

Puntatore a un oggetto IEntity che identifica il tipo di entità denominata da individuare.

[in] pszInputString

Tipo: LPCWSTR

Stringa di input in cui cercare parole chiave di entità denominate.

[in] pTokenCollection

Tipo: ITokenCollection*

Puntatore alla tokenizzazione della stringa nel parametro pszInputString .

[in] cTokensBegin

Tipo: ULONG

Posizione in base zero di un token in pTokenCollection da cui iniziare la ricerca.

[out] pcTokensLength

Tipo: ULONG*

Riceve un puntatore al numero di token coperti dalla parola chiave entity denominata trovata.

[out] ppszValue

Tipo: LPWSTR*

Riceve un puntatore al valore dell'entità denominata trovata, come stringa Unicode. Il chiamante deve liberare la stringa chiamando CoTaskMemFree. È possibile ottenere un oggetto INamedEntity chiamando il metodo GetNamedEntity di pEntity e passando la stringa ricevuta in questo parametro.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se la sequenza di token a partire dalla posizione cTokensBegin indica un'entità denominata del tipo specificato (entità). Se non esiste una sequenza di token di questo tipo, restituisce S_FALSE.

Commenti

Il metodo trova solo entità denominate create con parole chiave nello schema, non entità denominate riconosciute da un oggetto IConditionGenerator .

Requisiti