CopyEnhMetaFileW 函式 (wingdi.h)

CopyEnhMetaFile 函式會將增強格式元檔的內容複製到指定的檔案。

語法

HENHMETAFILE CopyEnhMetaFileW(
  [in] HENHMETAFILE hEnh,
  [in] LPCWSTR      lpFileName
);

[in] hEnh

要複製之增強元檔的句柄。

[in] lpFileName

目的地檔名的指標。如果此參數為 NULL，來源元檔會複製到記憶體。

如果函式成功，傳回值就是增強型元文件複本的句柄。

如果函式失敗，傳回值為 NULL。

其中文字自變數必須使用 Unicode 字元，請使用 CopyEnhMetaFile 函式作為寬字元函式。其中文字自變數必須使用 Windows 字元集中的字元，請使用此函式作為 ANSI 函式。

應用程式可以使用儲存在記憶體中的元檔進行暫存作業。

當應用程式不再需要增強型元檔句柄時，它應該藉由呼叫 DeleteEnhMetaFile 函式來刪除句柄。

注意

wingdi.h 標頭會將 CopyEnhMetaFile 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll