IStorage::OpenStream メソッド (objidl.h)

OpenStream メソッドは、指定したアクセス モードで、このストレージ オブジェクト内の既存のストリーム オブジェクトを開きます。

構文

HRESULT OpenStream(
  [in]  const OLECHAR *pwcsName,
  [in]  void          *reserved1,
  [in]  DWORD         grfMode,
  [in]  DWORD         reserved2,
  [out] IStream       **ppstm
);

パラメーター

[in] pwcsName

開くストリームの名前を含むワイド文字の null で終わる Unicode 文字列へのポインター。 ストリーム/ストレージ名の最初の文字として機能する 000 から 01f の文字は、OLE で使用するために予約されています。 これは複合ファイルの制限であり、構造化ストレージの制限ではありません。

[in] reserved1

将来の使用のために予約されています。 は NULL である必要があります。

[in] grfMode

開いているストリームに割り当てるアクセス モードを指定します。 使用可能な値の詳細と説明については、「 STGM 定数」を参照してください。 選択する他のモードでは、複合ファイルの実装でこのメソッドを呼び出すときに、少なくとも STGM_SHARE_EXCLUSIVE を指定する必要があります。

[in] reserved2

今後使用するために予約されています。0 にする必要があります。

[out] ppstm

新しく開かれたストリーム オブジェクトへのインターフェイス ポインターを受け取る IStream ポインター変数へのポインター。 エラーが発生した場合は、*ppstm を NULL に設定する必要があります。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

注釈

IStorage::OpenStream は 、grfMode で指定されたアクセス モードで、このストレージ オブジェクト内の既存のストリーム オブジェクトを開きます。 grfMode で指定できるアクセス許可には制限があります。 たとえば、このストレージ オブジェクトに対するアクセス許可によって、ストリームに対するアクセス許可が制限されます。 一般に、ストリームのアクセス制限は、親ストレージのアクセス制限よりも厳しくする必要があります。 複合ファイル ストリームは、STGM_SHARE_EXCLUSIVEで開く必要があります。

要件

こちらもご覧ください

IStorage - 複合ファイルの実装

IStorage::CreateStream

Istream