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**

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

戻り値

型: HRESULT

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

要件

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