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