DestroyCursor
A version of this page is also available for
4/8/2010
This function destroys a cursor created by the CreateCursor function and frees any memory the cursor occupied. Do not use this function to destroy a cursor that was not created with the CreateCursor function.
Syntax
BOOL DestroyCursor(
HCURSOR hCursor
);
Parameters
- hCursor
[in] Handle to the cursor to be destroyed. The cursor must not be in use.
Return Value
Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.
Remarks
This function destroys a non-shared cursor. Do not use this function to destroy a shared cursor. A shared cursor is valid as long as the module from which it was loaded remains in memory. The following list shows functions that obtain a shared cursor:
- LoadCursor
- LoadImage (if you use the LR_SHARED flag)
Requirements
| Header | winuser.h |
| Library | Iconcurs.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |