次の方法で共有


OleConvertOLESTREAMToIStorageEx 関数 (ole2.h)

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 の既定のキャッシュ リソースを使用せず、変換リソースを使用するアプリケーションで使用できます。

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

要件

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

こちらもご覧ください

CoIsOle1Class

OleConvertIStorageToOLESTREAM

OleConvertIStorageToOLESTREAMEx

OleConvertOLESTREAMToIStorage

STGMEDIUM

Tymed