DestroyIcon 函式 (winuser.h)

發行項
03/13/2024

終結圖示，並釋放圖示所佔用的任何記憶體。

語法

BOOL DestroyIcon(
  [in] HICON hIcon
);

參數

[in] hIcon

類型： HICON

要終結之圖標的句柄。圖示不得正在使用中。

傳回值

類型： BOOL

如果函式成功，則傳回非零的值。

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

備註

只需要針對以下列函式建立的圖示和游標呼叫 DestroyIcon：如果呼叫而不使用 LR_SHARED 旗標) CreateIconIndirect 和 CopyIcon，CreateIconFromResourceEx (。請勿使用此函式來終結共享圖示。只要載入的模組保留在記憶體中，共享圖示就有效。下列函式會取得共享圖示。

LoadIcon
如果您使用 LR_SHARED 旗標) LoadImage (
如果您使用 LR_COPYRETURNORG 旗標，而 hImage 參數是共用圖示 ) (
CreateIconFromResource
如果您使用 LR_SHARED 旗標) createIconFromResourceEx (

規格需求

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