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

Статья
11/20/2024

Функция 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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wingdi.h (включая Windows.h)
библиотеки	Gdi32.lib
DLL	Gdi32.dll

См. также

DeleteEnhMetaFile

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

Обзор метафайлов

Поделиться через