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

Статья
08/27/2023

Извлекает данные из буфера обмена в указанном формате. Буфер обмена должен быть открыт ранее.

Синтаксис

HANDLE GetClipboardData(
  [in] UINT uFormat
);

Параметры

[in] uFormat

Тип: UINT

Формат буфера обмена. Описание стандартных форматов буфера обмена см. в разделе Стандартные форматы буфера обмена.

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

Тип: HANDLE

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

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

Буфер обмена управляет дескриптором, возвращаемым функцией GetClipboardData , а не приложением. Приложение должно немедленно скопировать данные. Приложение не должно освобождать дескриптор и не оставлять его заблокированным. Приложение не должно использовать дескриптор после вызова функции EmptyClipboard или CloseClipboard или после вызова функции SetClipboardData с тем же форматом буфера обмена.

Система выполняет неявное преобразование формата данных между определенными форматами буфера обмена, когда приложение вызывает функцию GetClipboardData . Например, если формат CF_OEMTEXT находится в буфере обмена, окно может получить данные в формате CF_TEXT . Формат в буфере обмена преобразуется в запрошенный формат по запросу. Дополнительные сведения см. в разделе Синтезированные форматы буфера обмена.

Примеры

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

Требования


Минимальная версия клиента	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)