This function retrieves data from the clipboard in a specified format.

HANDLE GetClipboardData(
UINT uFormat); 


  • uFormat
    [in] Unsigned integer that specifies a clipboard format. For a description of the standard clipboard formats, see SetClipboardData.

Return Values

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.


Windows CE does not support automatic data format conversions between clipboard formats.

An application can enumerate the available formats in advance by using the EnumClipboardFormats function.

The clipboard controls the handle that the GetClipboardData function returns, not the application. The application should copy the data immediately. The application cannot rely on being able to make long-term use of the handle. The application must not free the handle nor leave it locked.


Runs On Versions Defined in Include Link to
Windows CE OS 1.0 and later Winuser.h   Clipbd.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.