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