Función EmptyClipboard (winuser.h)

Vacía el Portapapeles y libera los identificadores de los datos del Portapapeles. A continuación, la función asigna la propiedad del Portapapeles a la ventana que tiene abierto el Portapapeles.

Sintaxis

BOOL EmptyClipboard();

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

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

Comentarios

Antes de llamar a EmptyClipboard, una aplicación debe abrir el Portapapeles mediante la función OpenClipboard . Si la aplicación especifica un identificador de ventana NULL al abrir el Portapapeles, EmptyClipboard se realiza correctamente, pero establece el propietario del Portapapeles en NULL. Tenga en cuenta que esto hace que SetClipboardData produzca un error.

Ejemplos

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

Requisitos

Requisito Value
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 (incluir 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)

Consulte también

Portapapeles

Conceptual

OpenClipboard

Referencia

SetClipboardData

WM_DESTROYCLIPBOARD