共用方式為


CopyEnhMetaFileA 函式 (wingdi.h)

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

語法

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

參數

[in] hEnh

要複製之增強元檔句柄。

[in] lpFileName

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

傳回值

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

如果函式失敗,則傳回值 NULL

言論

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

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

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

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 wingdi.h (包括 Windows.h)
連結庫 Gdi32.lib
DLL Gdi32.dll

另請參閱

DeleteEnhMetaFile

元檔函式

元檔概觀