Функция DestroyCursor (winuser.h)

Уничтожает курсор и освобождает память, занятую курсором. Не используйте эту функцию для уничтожения общего курсора.

Синтаксис

BOOL DestroyCursor(
  [in] HCURSOR hCursor
);

Параметры

[in] hCursor

Тип: HCURSOR

Дескриптор курсора, который необходимо уничтожить. Курсор не должен использоваться.

Возвращаемое значение

Тип: BOOL

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Функция DestroyCursor уничтожает курсор без общего доступа. Не используйте эту функцию для уничтожения общего курсора. Общий курсор действителен до тех пор, пока модуль, из которого он был загружен, остается в памяти. Следующие функции получают общий курсор:

  • LoadCursor
  • LoadCursorFromFile
  • LoadImage (если используется флаг LR_SHARED )
  • CopyImage (если используется флаг LR_COPYRETURNORG , а параметр hImage является общим курсором)

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll

См. также раздел

Основные понятия

CopyCursor

CopyImage

CreateCursor

Курсоры

LoadCursor

LoadCursorFromFile

LoadImage

Справочные материалы