Shell_GetCachedImageIndexA関数 (shlobj_core.h)

[Shell_GetCachedImageIndex は、[要件] セクションで指定したオペレーティング システムで使用できます。 以降のバージョンでは、変更または使用できない場合があります。 代わりに、Shell_GetCachedImageIndexA または Shell_GetCachedImageIndexWを使用してください。

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

構文

int Shell_GetCachedImageIndexA(
  LPCSTR pszIconPath,
  int    iIconIndex,
  UINT   uIconFlags
);

パラメーター

pszIconPath

未定

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 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	shlobj_core.h (Shlobj.h、Shlobj_core.h、Shlobj.h、Shlobj_core.h を含む)
ライブラリ	Shell32.lib
DLL	Shell32.dll (バージョン 5.0 以降)
API セットの	ext-ms-win-shell-shell32-l1-2-1 (Windows 10 バージョン 10.0.10240 で導入)

関連項目

FileIconInit