Поделиться через


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

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

Синтаксис

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)

См. также раздел

Буфер обмена

Основные понятия

OpenClipboard

Справочные материалы

SetClipboardData

WM_DESTROYCLIPBOARD