OleConvertOLESTREAMToIStorageEx 函式 (ole2.h)

發行項
03/09/2024

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