CopyEnhMetaFileA 関数 (wingdi.h)

CopyEnhMetaFile 関数は、拡張形式のメタファイルの内容を指定したファイルにコピーします。

構文

HENHMETAFILE CopyEnhMetaFileA(
  [in] HENHMETAFILE hEnh,
  [in] LPCSTR       lpFileName
);

パラメーター

[in] hEnh

コピーする拡張メタファイルへのハンドル。

[in] lpFileName

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

戻り値

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

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

解説

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

アプリケーションでは、メモリに格納されているメタファイルを一時的な操作に使用できます。

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

注意

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

要件

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

関連項目

DeleteEnhMetaFile

メタファイル関数

メタファイルの概要