Función GetClipboardData (winuser.h)

Artículo
08/27/2023

Recupera datos del Portapapeles en un formato especificado. El Portapapeles debe haberse abierto anteriormente.

Sintaxis

HANDLE GetClipboardData(
  [in] UINT uFormat
);

Parámetros

[in] uFormat

Tipo: UINT

Formato del Portapapeles. Para obtener una descripción de los formatos estándar del Portapapeles, consulte Formatos estándar del Portapapeles.

Valor devuelto

Tipo: HANDLE

Si la función se ejecuta correctamente, el valor devuelto es el identificador de un objeto del Portapapeles en el formato especificado.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Precaución Los datos del Portapapeles no son de confianza. Analice cuidadosamente los datos antes de usarlos en la aplicación.

Una aplicación puede enumerar los formatos disponibles de antemano mediante la función EnumClipboardFormats .

El Portapapeles controla el identificador que devuelve la función GetClipboardData , no la aplicación. La aplicación debe copiar los datos inmediatamente. La aplicación no debe liberar el identificador ni dejarlo bloqueado. La aplicación no debe usar el identificador después de llamar a la función EmptyClipboard o CloseClipboard , o después de llamar a la función SetClipboardData con el mismo formato de Portapapeles.

El sistema realiza conversiones implícitas de formato de datos entre determinados formatos del Portapapeles cuando una aplicación llama a la función GetClipboardData . Por ejemplo, si el formato CF_OEMTEXT está en el Portapapeles, una ventana puede recuperar datos en el formato CF_TEXT . El formato del Portapapeles se convierte en el formato solicitado a petición. Para obtener más información, vea Formatos de Portapapeles sintetizados.

Ejemplos

Para obtener un ejemplo, vea Copiar información en el Portapapeles.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-misc-l1-2-0 (introducido en Windows 8.1)