CopyCursor macro (winuser.h)

Copies the specified cursor.

Syntax

HCURSOR CopyCursor(
  [in] pcur
);

Parameters

[in] pcur

Type: HCURSOR

A handle to the cursor to be copied.

Return value

Type: HCURSOR

If the call succeeds, the return value is a handle to the duplicate cursor.

If the call fails, the return value is NULL. To get extended error information, call GetLastError.

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

See also

Conceptual

CopyIcon

CopyImage

Cursors

DestroyCursor

GetCursor

Reference

SetCursor

ShowCursor