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 |