IQueryParser::P arse 方法 (structuredquery.h)

剖析包含結構化查詢關鍵詞和/或內容的輸入字串,以產生 IQuerySolution 物件。

語法

HRESULT Parse(
  [in]          LPCWSTR        pszInputString,
  [in]          IEnumUnknown   *pCustomProperties,
  [out, retval] IQuerySolution **ppSolution
);

參數

[in] pszInputString

類型: LPCWSTR

要剖析之 Unicode 輸入字串的指標。

[in] pCustomProperties

類型: IEnumUnknown*

IRichChunk 物件的列舉,應用程式已辨識的每個自定義屬性各一個。 這個參數可以是 NULL,相當於空的列舉。

[out, retval] ppSolution

類型: IQuerySolution**

接收 IQuerySolution 物件。 呼叫端必須呼叫其 IUnknown::Release 方法來釋放 它。

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

對於每個 IRichChunk 物件,位置資訊會識別自定義屬性的字元範圍、字串值是實際屬性的名稱,而 PROPVARIANT 則未使用。 雖然可以使用任何屬性,但這些泛型屬性會特別針對此用途而包含:

  • System.StructuredQuery.CustomProperty.Boolean
  • System.StructuredQuery.CustomProperty.DateTime
  • System.StructuredQuery.CustomProperty.Integer
  • System.StructuredQuery.CustomProperty.FloatingPoint
  • System.StructuredQuery.CustomProperty.String
應用程式可以在 pCustomProperties 參數中傳遞的列舉中使用它們,並在產生的條件樹狀結構中尋找它們。

規格需求

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