IFolderFilterSite::SetFilter メソッド (shobjidl_core.h)

クライアントがホストに IUnknown インターフェイス ポインターを渡せるように、ホストによって公開されます。

構文

HRESULT SetFilter(
  [in] IUnknown *punk
);

パラメーター

[in] punk

種類: IUnknown*

クライアントの IUnknown インターフェイスへのポインター。 フィルター処理を終了し、 IFolderFilter インターフェイスの呼び出しを停止するようにホストに通知するには、このパラメーターを NULL に設定 します。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

ホストの IFolderFilterSite インターフェイスへのポインターを取得した後、このメソッドを呼び出して、ホストに IUnknown インターフェイスへのポインターを渡します。 その後、ホストはこのポインターを使用して QueryInterface メソッドを呼び出し、 IFolderFilter インターフェイスへのポインターを要求します。 この呼び出しが失敗した場合、 IFolderFilterSite::SetFilter は E_NOINTERFACEAVAILABLEを返します。 呼び出しが成功した場合、ホストは IFolderFilter インターフェイスの 2 つのメソッドを呼び出して、フォルダーの内容を列挙する方法を決定します。

要件

サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)
[DLL]	Shell32.dll