GetIconInfo 函式 (winuser.h)

擷取指定之圖示或游標的相關信息。

語法

BOOL GetIconInfo(
  [in]  HICON     hIcon,
  [out] PICONINFO piconinfo
);

[in] hIcon

類型： HICON

圖示或游標的句柄。

若要擷取標準圖示或數據指標的相關信息，請指定開頭為IDI_前置詞的標識符，或以此參數中開頭為IDC_前置詞的標識符。

[out] piconinfo

類型： PICONINFO

ICONINFO 結構的指標。函式會填入結構的成員。

類型： BOOL

如果函式成功，則傳回值為非零，且函式會填入指定 ICONINFO 結構的成員。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

GetIconInfo 會為 hbmMask 和 hbmColor 或 ICONINFO 的成員建立位圖。呼叫端應用程式必須管理這些點陣圖，並在不再需要時使用DeleteObject 呼叫加以刪除。

此 API 不會參與 DPI 虛擬化。傳回的輸出不會受到呼叫線程的 DPI 影響。

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-gui-l1-1-0 (於 Windows 8)