GetClipboardDataAlloc (Windows CE 5.0)

Send Feedback

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

HANDLEGetClipboardDataAlloc(UINTuFormat);

Parameters

  • uFormat
    [in] Unsigned integer that specifies the clipboard format of the data being retrieved.

Return Values

The handle to a clipboard object in the specified format indicates success. NULL indicates failure. To get extended error information, call GetLastError.

Remarks

The GetClipboardDataAlloc function can potentially save an extra memory allocation in cases where the clipboard data is being transferred across processes.

GetClipboardDataAlloc works like the GetClipboardData function except it returns a handle to the memory allocated for the clipboard data in the caller's process. This memory is owned by the calling process and needs to be freed using LocalFree when no longer in use. GetClipboardDataAlloc should be used if the caller would usually call the GetClipboardData function and then the LocalAlloc function before copying the data.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Winuser.h.
Link Library: Clipbd.lib.

See Also

GetClipboardData | LocalAlloc | LocalFree | Clipboards Functions

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.