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

Статья
08/27/2023

Функция CopyMetaFile копирует содержимое метафайла в формате Windows в указанный файл.

Примечание Эта функция предоставляется только для совместимости с метафайлами в формате Windows. Метафайлы расширенного формата предоставляют превосходные функциональные возможности и рекомендуются для новых приложений. Соответствующая функция для метафайла расширенного формата — CopyEnhMetaFile.

Синтаксис

HMETAFILE CopyMetaFileW(
  [in] HMETAFILE unnamedParam1,
  [in] LPCWSTR   unnamedParam2
);

Параметры

[in] unnamedParam1

Дескриптор исходного метафайла в формате Windows.

[in] unnamedParam2

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

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

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

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

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

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

Примечание

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

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll

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

DeleteMetaFile

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

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

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