Функция EmptyClipboard (winuser.h)

Статья
08/27/2023

Очищает буфер обмена и освобождает дескрипторы данных в буфере обмена. Затем функция назначает право владения буфером обмена окну, в которое в настоящее время открыт буфер обмена.

Синтаксис

BOOL EmptyClipboard();

Возвращаемое значение

Тип: BOOL

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Перед вызовом EmptyClipboard приложение должно открыть буфер обмена с помощью функции OpenClipboard . Если приложение указывает маркер окна NULL при открытии буфера обмена, EmptyClipboard выполняется успешно, но задает владельцу буфера обмена значение NULL. Обратите внимание, что это приводит к сбою SetClipboardData .

Примеры

Пример см. в разделе Копирование данных в буфер обмена.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-misc-l1-2-0 (представлено в Windows 8.1)