SHGetStockIconInfo 関数 (shellapi.h)

[アーティクル]
03/01/2024

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

構文

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 で導入)

次の方法で共有