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 呼叫加以刪除。
DPI 虛擬化
此 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) |
另請參閱
概念