Макрос CopyCursor (winuser.h)

2025-09-03

Копирует указанный курсор.

Синтаксис

HCURSOR CopyCursor(
  [in] pcur
);

Параметры

[in] pcur

Тип: HCURSOR

Дескриптор для копирования курсора.

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

Тип: HCURSOR

Если вызов выполнен успешно, возвращаемое значение является дескриптором повторяющегося курсора.

Если вызов завершается ошибкой, возвращаемое значение равно NULL. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

CopyCursor позволяет приложению или библиотеке DLL получить дескриптор к фигуре курсора, принадлежащей другому модулю. Затем, если другой модуль освобожден, приложение по-прежнему может использовать фигуру курсора.

Перед закрытием приложение должно вызвать функцию DestroyCursor , чтобы освободить все системные ресурсы, связанные с курсором.

Не используйте функцию CopyCursor для анимированных курсоров. Вместо этого используйте функцию CopyImage .

CopyCursor реализуется как вызов функции CopyIcon .

#define CopyCursor(pcur) ((HCURSOR)CopyIcon((HICON)(pcur)))

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Windows
Header	winuser.h (включая Windows.h)