Функция GetEnhMetaFileBits (wingdi.h)

Функция GetEnhMetaFileBits извлекает содержимое указанного метафайла расширенного формата и копирует его в буфер.

Синтаксис

UINT GetEnhMetaFileBits(
  [in]  HENHMETAFILE hEMF,
  [in]  UINT         nSize,
  [out] LPBYTE       lpData
);

Параметры

[in] hEMF

Дескриптор расширенного метафайла.

[in] nSize

Размер (в байтах) буфера для получения данных.

[out] lpData

Указатель на буфер, получающий данные метафайла. Буфер должен быть достаточно большим, чтобы содержать данные. Если lpbBuffer имеет значение NULL, функция возвращает размер, необходимый для хранения данных.

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

Если функция выполняется успешно и указатель буфера имеет значение NULL, возвращаемое значение — это размер расширенного метафайла в байтах.

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

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

Комментарии

После извлечения битов расширенного метафайла их можно использовать для создания метафайла на основе памяти путем вызова функции SetEnhMetaFileBits .

Функция GetEnhMetaFileBits не делает дескриптор расширенного метафайла недействительным. Приложение должно вызвать функцию DeleteEnhMetaFile , чтобы удалить дескриптор, когда он больше не нужен.

Содержимое метафайла, полученное этой функцией, представлено в расширенном формате. Чтобы получить содержимое метафайла в формате Windows, используйте функцию GetWinMetaFileBits .

Требования

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

DeleteEnhMetaFile

GetWinMetaFileBits

Функции метафайлов

Общие сведения о метафайлах

SetEnhMetaFileBits