Compartilhar via


Função GetPriorityClipboardFormat (winuser.h)

Recupera o primeiro formato de área de transferência disponível na lista especificada.

Sintaxe

int GetPriorityClipboardFormat(
  [in] UINT *paFormatPriorityList,
  [in] int  cFormats
);

Parâmetros

[in] paFormatPriorityList

Tipo: UINT*

Os formatos da área de transferência, em ordem de prioridade. Para obter uma descrição dos formatos de área de transferência padrão, consulte Formatos de área de transferência padrão .

[in] cFormats

Tipo: int

O número de entradas na matriz paFormatPriorityList . Esse valor não deve ser maior do que o número de entradas na lista.

Valor retornado

Tipo: int

Se a função for bem-sucedida, o valor retornado será o primeiro formato de área de transferência na lista para a qual os dados estão disponíveis. Se a área de transferência estiver vazia, o valor retornado será NULL. Se a área de transferência contiver dados, mas não em nenhum dos formatos especificados, o valor retornado será –1. Para obter informações de erro estendidas, chame GetLastError.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-misc-l1-5-1 (introduzido no Windows 10, versão 10.0.14393)

Confira também

Área de transferência

Conceitual

CountClipboardFormats

Enumclipboardformats

GetClipboardFormatName

IsClipboardFormatAvailable

Referência

Registerclipboardformat