IApplicationAssociationRegistration::QueryCurrentDefault メソッド (shobjidl_core.h)

特定の関連付けの種類の既定のアプリケーションを決定します。 これは、その型に対して ShellExecute によって起動される既定のアプリケーションです。

構文

HRESULT QueryCurrentDefault(
  [in]  LPCWSTR          pszQuery,
  [in]  ASSOCIATIONTYPE  atQueryType,
  [in]  ASSOCIATIONLEVEL alQueryLevel,
  [out] LPWSTR           *ppszAssociation
);

パラメーター

[in] pszQuery

種類: LPCWSTR

ファイル名拡張子またはプロトコル (.mp3 や http など) を含む null で終わる Unicode 文字列へのポインター。

[in] atQueryType

種類: ASSOCIATIONTYPE

アソシエーションの種類 (拡張機能や MIME の種類など) を指定する ASSOCIATIONTYPE 列挙値の 1 つ。

[in] alQueryLevel

種類: ASSOCIATIONLEVEL

ユーザーごとやコンピューターなど、関連付けのレベルを指定する ASSOCIATIONLEVEL 列挙値の 1 つ。 これは通常 AL_EFFECTIVE。

[out] ppszAssociation

種類: LPWSTR*

このメソッドが戻るときに、 には、現在の既定の関連付けを識別する ProgID へのポインターのアドレスが含まれます。

メモ 呼び出し元のアプリケーションは、 CoTaskMemFree を介して文字列を解放する必要があります。

 

戻り値

型: HRESULT

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

注釈

通常、生成される文字列は、登録されたアプリケーションに関連付けられている ProgID のいずれかに一致する ProgID ですが、いくつかの例外があります。返される文字列がコンピューターの既定のプロトコルである場合は、ProgID ではなく .exe ハンドラーへのコマンド ラインを示すレガシ文字列です。 同様に、コンピューターの既定の MIME の種類を返す場合は、ProgID ではなくレガシ クラス識別子 (CLSID) 文字列を返します。

要件

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

こちらもご覧ください

既定のプログラム

IApplicationAssociationRegistration