Función GetClipboardData (winuser.h)

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

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

Consulte también

Portapapeles

CloseClipboard

Conceptual

EmptyClipboard

EnumClipboardFormats

Referencia

SetClipboardData