OleConvertIStorageToOLESTREAMEx 関数 (ole2.h)

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

構文

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 関数は渡さない点で OleConvertIStorageToOLESTREAM 関数とは異なります。

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

STGMEDIUM の tymed メンバーの値は、TYMED_HGLOBALまたはTYMED_ISTREAMである必要があります。詳細については、TYMED 列挙を参照してください。 メディアは OleConvertIStorageToOLESTREAMEx 関数によって解放されません。

要件

こちらもご覧ください

CoIsOle1Class

OleConvertIStorageToOLESTREAM

OleConvertOLESTREAMToIStorage

OleConvertOLESTREAMToIStorageEx

STGMEDIUM

Tymed