GetEnhMetaFileBits 函式 (wingdi.h)

GetEnhMetaFileBits函式會擷取指定增強格式中繼檔的內容，並將其複製到緩衝區。

語法

UINT GetEnhMetaFileBits(
  [in]  HENHMETAFILE hEMF,
  [in]  UINT         nSize,
  [out] LPBYTE       lpData
);

[in] hEMF

增強型中繼檔控制碼。

[in] nSize

要接收資料的緩衝區大小，以位元組為單位。

[out] lpData

接收中繼檔資料的緩衝區指標。緩衝區必須夠大，才能包含資料。如果 lpbBuffer 為 Null，函式會傳回保存資料所需的大小。

如果函式成功且緩衝區指標為 Null，則傳回值會是增強型中繼檔的大小，以位元組為單位。

如果函式成功，而且緩衝區指標是有效的指標，則傳回值會是複製到緩衝區的位元組數目。

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

擷取增強型中繼檔位之後，即可藉由呼叫 SetEnhMetaFileBits 函式來建立記憶體型中繼檔。

GetEnhMetaFileBits函式不會使 enhanced-metafile 控制碼失效。應用程式必須呼叫 DeleteEnhMetaFile 函式，才能在不再需要時刪除控制碼。

此函式所擷取的中繼檔內容格式為增強格式。若要擷取 Windows 格式的中繼檔內容，請使用 GetWinMetaFileBits 函式。


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll