IAssocHandler::GetIconLocation メソッド (shobjidl_core.h)

  • [アーティクル]

アプリケーションに関連付けられているアイコンの場所を取得します。

構文

HRESULT GetIconLocation(
  [out] LPWSTR *ppszPath,
  [out] int    *pIndex
);

パラメーター

[out] ppszPath

種類: LPWSTR*

このメソッドが戻るときに、 には、アプリケーションのアイコンへのパスを含む null で終わる Unicode 文字列へのポインターのアドレスが含まれます。

[out] pIndex

型: int*

このメソッドから制御が戻るときに、 ppszPath 内の という名前のリソース内のアイコンのインデックスへのポインターが含まれます。

戻り値

型: HRESULT

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

注釈

アイコンが見つからない場合、関数は実行可能ファイルへのパスと 0 のアイコン インデックスを返します。

パフォーマンス上の理由から、アプリケーションはシェル イメージ キャッシュを使用してアイコンを取得し、返されたパスからアイコンを直接読み込むのではなく、アイコンを取得できます。 パスとアイコンのインデックスは、 Shell_GetCachedImageIndexに直接渡すことができます。 この利点の 1 つは、アプリケーションでアイコンが使用できなかった場合に、シェル キャッシュで既定のアイコンを提供できることです。

要件

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