DestroyIcon

小甲鱼

注：本文档由 TOP_LK 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

DestroyIcon 函数用于销毁一个图标并释放其占用的内存。


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL WINAPI DestroyIcon(
  _In_ HICON hIcon
);

参数解析：

参数	含义
hIcon	1. 指向将被销毁的图标句柄 2. 该图标不能在使用中

返回值：

1. 如果函数调用成功，返回值为非 0；

2. 如果函数调用失败，返回值为 0。

3. 获取更多错误信息请调用 GetLastError 函数。


备注：

1. 只有使用如下函数创建的图标和光标才需要调用 DestroyIcon 函数销毁：CreateIconFromResourceEx 函数（如果没有 LR_shared 标记），CreateIconIndirect 函数和 CopyIcon 函数。

2. 不要使用该函数去销毁一个共享的图标。只要加载它的模块存在于内存中，该共享图标便是有效的。下列函数包含一个共享图标：

• LoadIcon
• LoadImage（如果你使用 LR_SHARED 标记）
• CopyImage（如果你使用 LR_COPYRETURNORG 标记并且 hImage 参数是一个共享图标）
• CreateIconFromResource
• CreateIconFromResourceEx（如果你使用 LR_SHARED 标记）
  

需求：

Minimum supported client	Windows 2000 专业版 [仅桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [仅桌面应用程序]
Header	Winuser.h (包含于 Windows.h)
Library	User32.lib
DLL	User32.dll

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。