SHAssocEnumHandlers 関数 (shobjidl_core.h)

指定したファイル名拡張ハンドラーのセットの列挙オブジェクトを返します。

構文

SHSTDAPI SHAssocEnumHandlers(
  [in]  PCWSTR             pszExtra,
  [in]  ASSOC_FILTER       afFilter,
  [out] IEnumAssocHandlers **ppEnumHandler
);

[in] pszExtra

種類: PCWSTR

".jpg" など、1 つのファイルの種類の拡張子を含む null で終わるバッファーへのポインター。指定された拡張機能に関連付けられているハンドラーのみが列挙されます。このパラメーターは NULL にすることはできません。

[in] afFilter

種類: ASSOC_FILTER

pszExtra で指定された値から得たハンドラーの完全な一覧に適用される列挙ハンドラーフィルターを指定します。次のいずれかの値です。

[値]	説明
ASSOC_FILTER_NONE	すべてのハンドラーを返します。
ASSOC_FILTER_RECOMMENDED	推奨されるハンドラーのみを返します。ハンドラーは、インストール時にレジストリに推奨される状態を設定します。非推奨の初期状態は、ユーザー操作の結果として、後で推奨済み状態に昇格できます。

[out] ppEnumHandler

このメソッドから制御が戻るときに、 IEnumAssocHandlers オブジェクトへのポインターのアドレスが格納されます。

型: HRESULT

この関数が成功すると、 S_OKが返されます。そうでない場合は、HRESULT エラーコードを返します。

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