This function returns the first available clipboard format in the specified list.

int GetPriorityClipboardFormat(
UINT *paFormatPriorityList, 
int cFormats); 


  • paFormatPriorityList
    [in] Pointer to an array of unsigned integers identifying clipboard formats, in priority order. For a description of the standard clipboard formats, see SetClipboardData.
  • cFormats
    [in] Integer that contains the number of entries in the paFormatPriorityList array. This value must not be greater than the number of entries in the list.

Return Values

The first clipboard format in the list for which data is available indicates success. NULL indicates that the clipboard is empty. –1 indicates that the clipboard contains data, but not in any of the specified formats. To get extended error information, call GetLastError.


During a copy or cut operation, a window calls SetClipboardData to place data on the clipboard in as many clipboard formats as possible, ordered from the most descriptive clipboard format to the least descriptive. During a paste operation, an application can specify a different format priority order with GetPriorityClipboardFormat. This function returns the first format from the specified list that is found on the clipboard.


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.

See Also

CountClipboardFormats, EnumClipboardFormats, GetClipboardFormatName, IsClipboardFormatAvailable, RegisterClipboardFormat, SetClipboardData

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.