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