ISchemaProvider：：LookupAuthoredNamedEntity 方法 (structuredquery.h)

在標記化字串中尋找指定類型的具名實體，並傳回實體值所佔用的標記和標記數目。

語法

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

參數

[in] pEntity

類型： IEntity*

IEntity 物件的指標，識別要尋找的具名實體類型。

[in] pszInputString

類型： LPCWSTR

要在其中搜尋具名實體關鍵詞的輸入字串。

[in] pTokenCollection

類型： ITokenCollection*

pszInputString 參數中字串標記化的指標。

[in] cTokensBegin

類型： ULONG

要開始搜尋的 pTokenCollection 中令牌以零起始的位置。

[out] pcTokensLength

類型： ULONG*

接收所找到具名實體關鍵詞所涵蓋之令牌數目的指標。

[out] ppszValue

類型： LPWSTR*

接收所找到具名實體值的指標，做為 Unicode 字串。 呼叫端必須呼叫 CoTaskMemFree 來釋放字串。 您可以呼叫 pEntity 的 GetNamedEntity 方法並傳遞此參數中收到的字串，以取得 INamedEntity 物件。

傳回值

類型： HRESULT

如果從 位置開始的標記序列 cTokensBegin 表示指定之 (實體) 類型的具名實體，則傳回S_OK。 如果沒有這類令牌序列，則會傳回S_FALSE。

備註

方法只會尋找以架構中關鍵詞撰寫的具名實體，而不是 IConditionGenerator 物件所辨識的具名實體。

規格需求

需求	值
最低支援的用戶端	Windows XP 搭配 SP2、Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 SP1 [僅限傳統型應用程式]
目標平台	Windows
標頭	structuredquery.h
可轉散發套件	Windows 桌面搜尋 (WDS) 3.0