SHMapPIDLToSystemImageListIndex 関数 (shlobj_core.h)

[SHMapPIDLToSystemImageListIndex は、[要件] セクションで指定されたオペレーティング システムで使用できます。 以降のバージョンでは変更または使用できない場合があります。]

フォルダー アイテムに関連付けられているシステム イメージ リストからアイコン インデックスを取得します。

構文

int SHMapPIDLToSystemImageListIndex(
  [in]            IShellFolder    *pshf,
  [in]            PCUITEMID_CHILD pidl,
  [out, optional] int             *piIndexSel
);

パラメーター

[in] pshf

種類: IShellFolder*

アイテムを含むフォルダーの IShellFolder インターフェイス ポインター。

[in] pidl

種類: PCUITEMID_CHILD

項目の ITEMIDLIST 構造体へのポインター。

[out, optional] piIndexSel

型: int*

この関数が正常に返されると、システム イメージ リスト内の項目の開いているアイコンのインデックスを受け取る int へのポインター。 アイテムに特別な 開 いているアイコンがない場合は、通常のアイコンのインデックスが返されます。 開いているアイコンが存在し、取得できない場合、piIndex が指す値は -1 に設定されます。 呼び出し元のアプリケーションが開いているアイコンに関心がない場合、このパラメーターは NULL にすることができます。

戻り値

型: int

成功した場合はシステム イメージ リスト内の項目の標準アイコンのインデックスを返し、それ以外の場合は -1 を返します。

要件

サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shlobj_core.h
Library	Shell32.lib
[DLL]	Shell32.dll (バージョン 5.0 以降)