Shell_GetCachedImageIndexW関数 (shlobj_core.h)

[Shell_GetCachedImageIndex は、[要件] セクションで指定したオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 代わりに、 Shell_GetCachedImageIndexA または Shell_GetCachedImageIndexWを使用します。

キャッシュされたアイコンのキャッシュ インデックスを取得します。

構文

int Shell_GetCachedImageIndexW(
  LPCWSTR pszIconPath,
  int     iIconIndex,
  UINT    uIconFlags
);

パラメーター

pszIconPath

TBD

iIconIndex

型: int

pwszIconPath という名前のファイル内のイメージのインデックス。

uIconFlags

型: UINT

使用されていません。

戻り値

型: int

イメージのインデックスを返します。エラーが発生した場合は -1 を返します。

解説

この関数の Shell_GetCachedImageIndexA と Shell_GetCachedImageIndexW バージョンが Windows Vista に追加されました。 Unicode 文字列の場合は、 Shell_GetCachedImageIndexW または Shell_GetCachedImageIndex を呼び出します。 ANSI 文字列の場合は、 Shell_GetCachedImageIndexA を明示的に呼び出す必要があります。

Windows Server 2003 および Windows XP: Shell_GetCachedImageIndexのみがサポートされています。 Shell_GetCachedImageIndex には Unicode 文字列が必要です。

注意

shlobj_core.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてShell_GetCachedImageIndexを定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shlobj_core.h (Shlobj.h、Shlobj_core.h、Shlobj.h、Shlobj_core.h を含む)
Library	Shell32.lib
[DLL]	Shell32.dll (バージョン 5.0 以降)
API セット	ext-ms-win-shell-shell32-l1-2-1 (Windows 10 バージョン 10.0.10240 で導入)

関連項目

FileIconInit