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

Статья
11/20/2024

[GetMetaFile больше недоступен для использования в Windows 2000. Вместо этого используйте GetEnhMetaFile.]

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

Синтаксис

HMETAFILE GetMetaFileA(
  [in] LPCSTR lpName
);

Параметры

[in] lpName

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

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

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

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

Замечания

Эта функция не реализована в API Win32. Он предоставляется для совместимости с 16-разрядными версиями Windows. В приложениях Win32 используйте функцию GetEnhMetaFile.

Заметка

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

Требования

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

См. также

GetEnhMetaFile

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