SHGetStockIconInfo 函式 (shellapi.h)

發行項
03/05/2024

擷取系統定義殼層圖示的相關信息。

語法

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

參數

siid

類型： SHSTOCKICONID

SHSTOCKICONID 列舉中的其中一個值，指定應該擷取哪一個圖示。

uFlags

類型： UINT

下列旗標的零個或多個組合，指定要求的資訊。

SHGSI_ICONLOCATION

SHSTOCKICONINFO 結構的 szPath 和 iIcon 成員會接收所要求圖示的路徑和圖示索引，格式適合傳遞至 ExtractIcon 函式。此旗標的數值為零，因此不論其他旗標為何，您一律都會取得圖示位置。

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 錯誤碼。

備註

如果此函式傳回 SHSTOCKICONINFO 結構所指向之 SHSTOCKICONINFO 結構的 hIcon 成員中的圖示句柄，則當您不再需要該圖示時，您必須負責釋放具有 DestroyIcon 的圖示。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	shellapi.h
Dll	Shell32.dll
API 集合	ext-ms-win-shell32-l1-2-1 (於 Windows 10 10.0.10240 版)

共用方式為