OleConvertIStorageToOLESTREAMEx 函式 (ole2.h)
OleConvertIStorageToOLESTREAMEx 函式會將指定的儲存物件從 OLE 2 結構化記憶體轉換為 OLE 1 儲存物件模型,包括呈現數據。 這是結構化記憶體中包含的數個函式之一,可確保 OLE1 與 OLE2 之間的相容性。
語法
HRESULT OleConvertIStorageToOLESTREAMEx(
[in] LPSTORAGE pstg,
[in] CLIPFORMAT cfFormat,
[in] LONG lWidth,
[in] LONG lHeight,
[in] DWORD dwSize,
[in] LPSTGMEDIUM pmedium,
[out] LPOLESTREAM polestm
);
參數
[in] pstg
要轉換成 OLE 1 記憶體之記憶體物件上 IStorage 介面的指標。
[in] cfFormat
簡報數據的格式。 可以是 NULL,在此情況下會忽略 lWidth、 lHeight、 dwSize 和 pmedium 參數。
[in] lWidth
HIMETRIC 單位的對象呈現數據寬度。
[in] lHeight
HIMETRIC 單位的對象呈現數據高度。
[in] dwSize
要轉換的數據大小,以位元組為單位。
[in] pmedium
要轉換之串行化數據的 STGMEDIUM 結構的指標。
[out] polestm
數據流的指標,該數據流會使用 OLE 1 儲存模型來儲存物件的持續性表示法。
傳回值
除了下列專案外,此函式還支援標準傳回值E_INVALIDARG:
備註
OleConvertIStorageToOLESTREAMEx 函式會將 OLE 2 儲存物件轉換成 OLE 1 格式。 不同於 OleConvertIStorageToOLESTREAM 函式, OleConvertIStorageToOLESTREAMEx 函式也會將簡報數據傳遞至 OLE 1 儲存物件,而 OleConvertIStorageToOLESTREAM 函式則不會。
因為 OleConvertIStorageToOLESTREAMEx 可以指定要轉換的簡報數據,所以應用程式可以使用它,這些應用程式不會使用 OLE 預設快取資源,但使用 OLE 的轉換資源。
STGMEDIUM 之 tymed 成員的值必須是TYMED_HGLOBAL或TYMED_ISTREAM;如需詳細資訊,請參閱 TYMED 列舉。 媒體不會由 OleConvertIStorageToOLESTREAMEx 函 式釋放。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | ole2.h |
程式庫 | Ole32.lib |
Dll | Ole32.dll |