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 関数によって解放されません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ole2.h |
| Library | Ole32.lib |
| [DLL] | Ole32.dll |