createIconFromResource 函式 (winuser.h)

從描述圖示的資源位建立圖示或游標。

若要指定所需的高度或寬度，請使用 CreateIconFromResourceEx 函式。

語法

HICON CreateIconFromResource(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer
);

[in] presbits

類型： PBYTE

包含圖示或游標資源位的 DWORD 對齊緩衝區指標。這些位通常是透過呼叫 LookupIconIdFromDirectory、 LookupIconIdFromDirectoryEx 和 LoadResource 函式來載入。

如需圖示和數據指標資源格式的詳細資訊，請參閱數據指標和圖示資源。

[in] dwResSize

類型： DWORD

presbits 參數所指向之位集的大小，以位元組為單位。

[in] fIcon

類型： BOOL

指出要建立圖示或游標。如果此參數為 TRUE，則會建立圖示。如果是 FALSE，則會建立數據指標。

LOCALHEADER 結構會定義數據指標熱點，而且是從數據指標資源位讀取的第一個數據。

[in] dwVer

類型： DWORD

presbits 參數所指向之資源位的圖示或數據指標格式版本號碼。此值必須大於或等於 0x00020000，且小於或等於 0x00030000。此參數通常會設定為 0x00030000。

類型： HICON

如果函式成功，則傳回值是圖示或游標的句柄。

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

CreateIconFromResource、CreateIconFromResourceEx、CreateIconIndirect、GetIconInfo、LookupIconIdFromDirectory 和 LookupIconIdFromDirectoryEx 函式可讓殼層應用程式和圖示瀏覽器檢查和使用整個系統的資源。

CreateIconFromResource 函式會呼叫 CreateIconFromResourceEx 以旗標傳遞LR_DEFAULTSIZE|LR_SHARED。

您應該針對使用 CreateIconFromResource 所建立的數據指標呼叫 DestroyIcon 或 DestroyCursor。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	winuser.h (包含 Windows.h)
程式庫	User32.lib
Dll	User32.dll