CopyCursor

The CopyCursor function copies a cursor.

HCURSOR CopyCursor(
  HCURSOR pcur   // handle to cursor to copy
);
 

Parameters

pcur

Handle to the cursor to be copied.

Return Values

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

The CopyCursor function enables an application or dynamic-link library (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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in winuser.h.
  Import Library: Use user32.lib.

See Also

Cursors Overview, Cursor Functions, CopyIcon, DestroyCursor, GetCursor, SetCursor, ShowCursor