CopyCursor macro (winuser.h)

Copies the specified cursor.

Syntax

void CopyCursor(
  [in]  pcur
);

Parameters

[in] pcur

Type: HCURSOR

A handle to the cursor to be copied.

Return value

None

Remarks

CopyCursor enables an application or DLL to obtain the handle to a cursor shape owned by another module. Then if the other module is freed, the application is still able to use the cursor shape.

Before closing, an application must call the DestroyCursor function to free any system resources associated with the cursor.

Do not use the CopyCursor function for animated cursors. Instead, use the CopyImage function.

CopyCursor is implemented as a call to the CopyIcon function.

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

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header winuser.h (include Windows.h)

See also

Conceptual

CopyIcon

CopyImage

Cursors

DestroyCursor

GetCursor

Reference

SetCursor

ShowCursor