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

Статья
11/20/2024

Функция GetEnhMetaFile создает дескриптор, определяющий метафайл расширенного формата, хранящийся в указанном файле.

Синтаксис

HENHMETAFILE GetEnhMetaFileA(
  [in] LPCSTR lpName
);

Параметры

[in] lpName

Указатель на строку, завершающуюся значением NULL, которая указывает имя расширенного метафайла.

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

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

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

Замечания

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

Метафайл формата Windows необходимо преобразовать в расширенный формат, прежде чем его можно будет обработать функцией GetEnhMetaFile. Чтобы преобразовать файл, используйте функцию SetWinMetaFileBits.

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

Примеры

Пример см. в открытии расширенного метафайла и отображении его содержимого.

Заметка

Заголовок wingdi.h определяет GetEnhMetaFile как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wingdi.h (включая Windows.h)
библиотеки	Gdi32.lib
DLL	Gdi32.dll