CopyMetaFileA 関数 (wingdi.h)

CopyMetaFile 関数は、Windows 形式のメタファイルの内容を指定されたファイルにコピーします。

メモ この関数は、Windows 形式のメタファイルとの互換性のためにのみ提供されます。 拡張形式のメタファイルは優れた機能を提供し、新しいアプリケーションに推奨されます。 拡張形式メタファイルの対応する関数は 、CopyEnhMetaFile です。

 

構文

HMETAFILE CopyMetaFileA(
  [in] HMETAFILE unnamedParam1,
  [in] LPCSTR    unnamedParam2
);

パラメーター

[in] unnamedParam1

ソースの Windows 形式メタファイルへのハンドル。

[in] unnamedParam2

コピー先ファイルの名前へのポインター。 このパラメーターが NULL の場合、ソース メタファイルはメモリにコピーされます。

戻り値

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

関数が失敗した場合は、返される値は NULL です。

注釈

テキスト引数で Unicode 文字を使用する必要がある場合は、ワイド文字関数としてこの関数を使用します。 テキスト引数で Windows 文字セットの文字を使用する必要がある場合は、この関数を ANSI 関数として使用します。

アプリケーションで Windows 形式のメタファイル ハンドルが不要になった場合は、 DeleteMetaFile 関数を呼び出してハンドルを削除する必要があります。

注意

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

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll

こちらもご覧ください

DeleteMetaFile

メタファイル関数

メタファイルの概要