SHGetStockIconInfo 関数 (shellapi.h)

システム定義のシェル アイコンに関する情報を取得します。

構文

SHSTDAPI SHGetStockIconInfo(
            SHSTOCKICONID   siid,
            UINT            uFlags,
  [in, out] SHSTOCKICONINFO *psii
);

パラメーター

siid

種類: SHSTOCKICONID

取得するアイコンを指定する SHSTOCKICONID 列挙の値の 1 つ。

uFlags

型: UINT

要求する情報を指定する次のフラグの 0 個以上の組み合わせ。

SHGSI_ICONLOCATION

SHSTOCKICONINFO 構造体の szPath メンバーと iIcon メンバーは、ExtractIcon 関数への渡しに適した形式で、要求されたアイコンのパスとアイコン インデックスを受け取ります。 このフラグの数値は 0 なので、他のフラグに関係なく常にアイコンの場所を取得します。

SHGSI_ICON

SHSTOCKICONINFO 構造体の hIcon メンバーは、指定されたアイコンへのハンドルを受け取ります。

SHGSI_SYSICONINDEX

SHSTOCKICONINFO 構造体の iSysImageImage メンバーは、システム イメージリスト内の指定されたアイコンのインデックスを受け取ります。

SHGSI_LINKOVERLAY

関数がファイルのアイコンにリンク オーバーレイを追加して、SHGSI_ICON値を変更します。

SHGSI_SELECTED

関数がアイコンとシステムの強調表示の色をブレンドして、SHGSI_ICON値を変更します。

SHGSI_LARGEICON

SM_CXICONとSM_CYICONシステム メトリックで指定されているように、関数がアイコンの大きなバージョンを取得するようにして、SHGSI_ICON値を変更します。

SHGSI_SMALLICON

SM_CXSMICONとSM_CYSMICONシステム メトリックで指定された小さなバージョンのアイコンを関数が取得するようにして、SHGSI_ICON値を変更します。

SHGSI_SHELLICONSIZE

関数がシステム メトリックで指定されたサイズではなくシェル サイズのアイコンを取得するようにして、SHGSI_LARGEICONまたはSHGSI_SMALLICON値を変更します。

[in, out] psii

種類: SHSTOCKICONINFO*

SHSTOCKICONINFO 構造体へのポインター。 この関数を呼び出すときは、この構造体の cbSize メンバーを SHSTOCKICONINFO 構造体のサイズに設定する必要があります。 この関数が戻るときに、 には、要求された情報を含む SHSTOCKICONINFO 構造体へのポインターが含まれます。

戻り値

型: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

この関数が psii が指す SHSTOCKICONINFO 構造体の hIcon メンバーでアイコン ハンドルを返す場合は、不要になったときに DestroyIcon でアイコンを解放する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shellapi.h
[DLL]	Shell32.dll
API セット	ext-ms-win-shell-shell32-l1-2-1 (Windows 10 バージョン 10.0.10240 で導入)