GetMetaFileA 関数 (wingdi.h)

[GetMetaFile は、Windows 2000 の時点で使用できなくなりました。 代わりに、GetEnhMetaFile.] 使用します。

GetMetaFile 関数は、指定したファイルに格納されているメタファイルを識別するハンドルを作成します。

構文

HMETAFILE GetMetaFileA(
  [in] LPCSTR lpName
);

パラメーター

[in] lpName

メタファイルの名前を指定する null で終わる文字列へのポインター。

戻り値

関数が成功した場合、戻り値はメタファイルへのハンドルです。

関数が失敗した場合、戻り値は NULL。

備考

この関数は Win32 API には実装されていません。 これは、16 ビット バージョンの Windows との互換性のために提供されます。 Win32 アプリケーションでは、GetEnhMetaFile 関数を使用します。

手記

wingdi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetMetaFile を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	wingdi.h (Windows.h を含む)
ライブラリ	Gdi32.lib
DLL	Gdi32.dll

関連項目

GetEnhMetaFile を する