CopyMetaFileW 函式 (wingdi.h)

CopyMetaFile函式會將 Windows 格式中繼檔的內容複寫到指定的檔案。

注意此函式僅供與 Windows 格式中繼檔相容。增強格式中繼檔提供較佳的功能，建議用於新的應用程式。增強格式中繼檔對應的函式是 CopyEnhMetaFile。

語法

HMETAFILE CopyMetaFileW(
  [in] HMETAFILE unnamedParam1,
  [in] LPCWSTR   unnamedParam2
);

[in] unnamedParam1

來源 Windows 格式中繼檔控制碼。

[in] unnamedParam2

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

如果函式成功，則傳回值是 Windows 格式中繼檔複本的控制碼。

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

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

當應用程式不再需要 Windows 格式中繼檔控制碼時，應該呼叫 DeleteMetaFile 函式來刪除控制碼。

注意

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