Функция GetEnhMetaFileA (wingdi.h)
Функция GetEnhMetaFile создает дескриптор, который идентифицирует метафайл расширенного формата, хранящийся в указанном файле.
Синтаксис
HENHMETAFILE GetEnhMetaFileA(
[in] LPCSTR lpName
);
Параметры
[in] lpName
Указатель на строку, завершающуюся null, которая указывает имя расширенного метафайла.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение является дескриптором для расширенного метафайла.
Если функция завершается сбоем, возвращается значение NULL.
Комментарии
Если приложению больше не нужен дескриптор расширенного метафайла, оно должно удалить дескриптор, вызвав функцию DeleteEnhMetaFile .
Метафайл в формате Windows должен быть преобразован в расширенный формат, прежде чем его можно будет обработать функцией GetEnhMetaFile . Чтобы преобразовать файл, используйте функцию SetWinMetaFileBits .
Если текстовые аргументы должны использовать символы Юникода, используйте эту функцию как функцию расширенных символов. Если текстовые аргументы должны использовать символы из кодировки Windows, используйте эту функцию как функцию ANSI.
Примеры
Пример см. в разделе Открытие расширенного метафайла и отображение его содержимого.
Примечание
Заголовок wingdi.h определяет GetEnhMetaFile в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wingdi.h (включая Windows.h) |
| Библиотека | Gdi32.lib |
| DLL | Gdi32.dll |