GetIconInfoExA 函式（winuser.h）

擷取指定之圖示或游標的相關信息。 GetIconInfoEx 會使用較新的 ICONINFOEX 結構來擴充 getIconInfo。

語法

BOOL GetIconInfoExA(
  [in]      HICON        hicon,
  [in, out] PICONINFOEXA piconinfo
);

[in] hicon

類型：HICON

圖示或游標的句柄。

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

[in, out] piconinfo

類型：PICONINFOEX

當這個方法傳回時，會包含iconINFOEX 結構的指標。函式會填入結構的成員。

類型：BOOL

TRUE 表示成功，FALSE 表示失敗。

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

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

注意

winuser.h 標頭會根據 UNICODE 預處理器常數的定義，將 GetIconInfoEx 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。