Função GetClipboardData (winuser.h)

Artigo
08/27/2023

Recupera dados da área de transferência em um formato especificado. A área de transferência deve ter sido aberta anteriormente.

Sintaxe

HANDLE GetClipboardData(
  [in] UINT uFormat
);

Parâmetros

[in] uFormat

Tipo: UINT

Um formato de área de transferência. Para obter uma descrição dos formatos de área de transferência padrão, consulte Formatos de área de transferência padrão.

Valor retornado

Tipo: HANDLE

Se a função for bem-sucedida, o valor retornado será o identificador para um objeto de área de transferência no formato especificado.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Cuidado Os dados da área de transferência não são confiáveis. Analise os dados cuidadosamente antes de usá-los em seu aplicativo.

Um aplicativo pode enumerar os formatos disponíveis com antecedência usando a função EnumClipboardFormats .

A área de transferência controla o identificador que a função GetClipboardData retorna, não o aplicativo. O aplicativo deve copiar os dados imediatamente. O aplicativo não deve liberar o identificador nem deixá-lo bloqueado. O aplicativo não deve usar o identificador depois que a função EmptyClipboard ou CloseClipboard for chamada ou depois que a função SetClipboardData for chamada com o mesmo formato de área de transferência.

O sistema executa conversões implícitas de formato de dados entre determinados formatos de área de transferência quando um aplicativo chama a função GetClipboardData . Por exemplo, se o formato CF_OEMTEXT estiver na área de transferência, uma janela poderá recuperar dados no formato CF_TEXT . O formato na área de transferência é convertido no formato solicitado sob demanda. Para obter mais informações, consulte Formatos de área de transferência sintetizados.

Exemplos

Para obter um exemplo, consulte Copiando informações para a área de transferência.

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-2-0 (introduzido no Windows 8.1)