GetEnhMetaFileA 函式 (wingdi.h)

GetEnhMetaFile函式會建立控制碼，以識別儲存在指定檔案中的增強格式中繼檔。

語法

HENHMETAFILE GetEnhMetaFileA(
  [in] LPCSTR lpName
);

[in] lpName

指定增強中繼檔名稱之 Null 終止字串的指標。

如果函式成功，則傳回值是增強中繼檔控制碼。

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

當應用程式不再需要增強型中繼檔控制碼時，應該呼叫 DeleteEnhMetaFile 函式來刪除控制碼。

Windows 格式中繼檔必須先轉換成增強格式， 才能由 GetEnhMetaFile 函式處理。若要轉換檔案，請使用 SetWinMetaFileBits 函式。

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

注意

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