get_clipboard_data


handle get_clipboard_data(unsigned format)

This function obtains data of a specified format from the clipboard.

Parameters

unsigned format

The format of the data to be retrieved.

Return

handle

The handle of the data of the specified format.

Notes

The data is owned by the clipboard; therefore, an application should copy the data should it be required. An application should not attempt to lock or free the data.

See set_clipboard_data for further information on the conversion that may be performed.

Prior to calling this function, the clipboard formats may be enumerated via the function enumerate_clipboard_formats.