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