DestroyIcon

This function destroys an icon and frees any memory the icon occupied.

At a Glance

Header file: Winuser.h
Windows CE versions: 1.0 and later

Syntax

BOOL DestroyIcon(HICON hIcon);

Parameters

hIcon

[in] Handle to the icon to be destroyed. The icon must not be in use.

Return Values

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

The DestroyIcon function may be called on the icon handle returned from CreateIconIndirect, ExtractIconEx, LoadImage or LoadIcon. The icon handle is invalid after calling DestroyIcon.

See Also

CreateIconIndirect