GetMetaFileA 函式 (wingdi.h)

[GetMetaFile 已不再可供 Windows 2000 使用。請改用 GetEnhMetaFile.]

GetMetaFile 函式會建立句柄，以識別儲存在指定檔案中的元檔。

語法

HMETAFILE GetMetaFileA(
  [in] LPCSTR lpName
);

[in] lpName

指定元檔名稱之 Null 終止字串的指標。

如果函式成功，則傳回值是元檔句柄。

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

此函式不會在 Win32 API 中實作。它提供以與16位版本的Windows相容。在 Win32 應用程式中，使用 GetEnhMetaFile 函式。

注意

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