OleConvertIStorageToOLESTREAMEx 関数 (ole2.h)

[アーティクル]
02/29/2024

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