OleConvertIStorageToOLESTREAMEx

OleConvertIStorageToOLESTREAMEx 関数は、指定されたストレージオブジェクトを OLE 2 構造化ストレージから OLE 1 ストレージオブジェクトモデルに、表示データを含めて変換する。

OleConvertIStorageToOLESTREAMEx pstg, cfFormat, lWidth, lHeight, dwSize, pmedium, polestm

pstg : [var] OLE 1 ストレージに変換する対象のストレージオブジェクト上の IStorage インターフェイスへのポインタ。
cfFormat : [int] 表示データの形式。NULL を指定することもでき、その場合、lWidth、lHeight、dwSize、および pmedium の各パラメータは無視される。
lWidth : [int] オブジェクト表示データの幅（HIMETRIC 単位）。
lHeight : [int] オブジェクト表示データの高さ（HIMETRIC 単位）。
dwSize : [int] 変換するデータのサイズ（バイト単位）。
pmedium : [var] 変換対象のシリアル化データに対する STGMEDIUM 構造体へのポインタ。
polestm : [var] OLE 1 ストレージモデルを使用してオブジェクトの永続的表現を保存するストリームへのポインタ。

(プラグイン / モジュール : ole32.dll)

解説

OleConvertIStorageToOLESTREAMEx 関数は、指定されたストレージオブジェクトを OLE 2
構造化ストレージから 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 関数によっては解放されない。

情報