OleConvertOLESTREAMToIStorageEx 関数 (ole2.h)

[アーティクル]
08/25/2023

OleConvertOLESTREAMToIStorageEx 関数は、指定したオブジェクトを OLE 1 ストレージモデルから、プレゼンテーションデータを含む OLE 2 構造化ストレージオブジェクトに変換します。これは、いくつかの互換性関数の 1 つです。

構文

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 オブジェクトに更新できます。

この関数は、OLESTREAM 構造体から読み取られたプレゼンテーションデータが渡され、新しく作成された OLE 2 ストレージオブジェクトにプレゼンテーションストリームが含まれていない点で、OleConvertOLESTREAMToIStorage 関数とは異なります。

この関数は変換するプレゼンテーションデータを指定できるため、OLE の既定のキャッシュリソースを使用せず、変換リソースを使用するアプリケーションで使用できます。

STGMEDIUM の tymed メンバーは、TYMED_NULLまたはTYMED_ISTREAMのみ可能です。 TYMED_NULL場合、データは STGMEDIUM の hGlobal メンバーを介してグローバルハンドルで返され、それ以外の場合は、この構造体の pstm メンバーにデータが書き込まれます。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	ole2.h
Library	Ole32.lib
[DLL]	Ole32.dll