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) |
| 程式庫 | Gdi32.lib |
| Dll | Gdi32.dll |