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 へのポインターのアドレスが含まれます。
戻り値
型: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
通常、生成される文字列は、登録されたアプリケーションに関連付けられている ProgID のいずれかに一致する ProgID ですが、いくつかの例外があります。返される文字列がコンピューターの既定のプロトコルである場合は、ProgID ではなく .exe ハンドラーへのコマンド ラインを示すレガシ文字列です。 同様に、コンピューターの既定の MIME の種類を返す場合は、ProgID ではなくレガシ クラス識別子 (CLSID) 文字列を返します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shobjidl_core.h (Shobjidl.h を含む) |