Export (0) Print
Expand All

CopyCursor function

Copies the specified cursor.

Syntax


HCURSOR WINAPI CopyCursor(
  _In_  HCURSOR pcur
);

Parameters

pcur [in]

Type: HCURSOR

A handle to the cursor to be copied.

Return value

Type: HCURSOR

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

If the function 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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

See also

Reference
CopyIcon
CopyImage
DestroyCursor
GetCursor
SetCursor
ShowCursor
Conceptual
Cursors

 

 

Community Additions

ADD
Show:
© 2014 Microsoft