OleConvertOLESTREAMToIStorageEx 函式 (ole2.h)
OleConvertOLESTREAMToIStorageEx 函式會將指定的物件從 OLE 1 儲存模型轉換為 OLE 2 結構化儲存物件,包括呈現數據。 這是數個相容性函式的其中一個。
語法
HRESULT OleConvertOLESTREAMToIStorageEx(
[in] LPOLESTREAM polestm,
[out] LPSTORAGE pstg,
[out] CLIPFORMAT *pcfFormat,
[out] LONG *plwWidth,
[out] LONG *plHeight,
[out] DWORD *pdwSize,
[out] LPSTGMEDIUM pmedium
);
參數
[in] polestm
數據流的指標,其中包含 OLE 1 儲存格式之對象的持續性表示法。
[out] pstg
OLE 2 結構化儲存物件的指標。
[out] pcfFormat
傳回簡報數據格式的指標。 可能是 NULL,表示沒有簡報數據。
[out] plwWidth
傳回簡報數據的 HIMETRIC) 寬度值 (的指標。
[out] plHeight
傳回簡報數據之 HIMETRIC) 中高度值 (的指標。
[out] pdwSize
傳回已轉換數據位元組大小之位置的指標。
[out] pmedium
傳回已轉換串行化數據 之 STGMEDIUM 結構的指標。
傳回值
此函式會傳回 HRESULT。
備註
此函式會將 OLE 1 物件轉換為 OLE 2 結構化儲存物件。 當新版的物件應用程式支援 OLE 2 時,您可以使用此函式,將 OLE 1 物件更新為 OLE 2 物件。
此函式與 OleConvertOLESTREAMToIStorage 函式不同,因為從 OLESTREAM 結構讀取的簡報數據會傳出,而新建立的 OLE 2 儲存物件不包含簡報數據流。
由於此函式可以指定要轉換的簡報數據,因此應用程式可以使用它,這些應用程式不會使用 OLE 的預設快取資源,但會使用轉換資源。
STGMEDIUM 的 tymed 成員只能TYMED_NULL或TYMED_ISTREAM。 如果是TYMED_NULL,則會透過 STGMEDIUM 的 hGlobal 成員,在全域句柄中傳回數據,否則數據會寫入此結構的 pstm 成員中。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | ole2.h |
程式庫 | Ole32.lib |
Dll | Ole32.dll |