iSearchBoxInfo：：GetCondition 方法 (shobjidl.h)

擷取搜尋方塊的內容做為 ICondition 物件。

語法

HRESULT GetCondition(
  [in]  REFIID riid,
  [out] void   **ppv
);

[in] riid

類型： REFIID

要透過 ppv 擷取之介面 IID 的參考，通常IID_ICondition。

[out] ppv

類型： void**

當這個方法成功傳回時，會包含 riid中要求的介面指標。這通常是 ICondition。

類型： HRESULT

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

與 ISearchBoxInfo：：GetText 所擷取的文字字串相反， GetCondition 會擷取與結構化物件相同的資訊，其方法可用來剖析及操作搜尋字串。

我們建議您使用 Objbase.h 中定義的 IID_PPV_ARGS 宏來封裝 riid 和 ppv 參數。這個宏會根據 ppv 中值所指向的介面提供正確的 IID，這可消除 riid 中可能導致非預期結果的程式代碼錯誤的可能性。