OleConvertIStorageToOLESTREAMEx 函式 (ole2.h)

發行項
03/05/2024

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