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 に設定する必要があります。

戻り値

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

リターン コード 説明
S_OK ストリームが正常に開きました。
E_PENDING 非同期ストレージのみ: ストリーム データの一部またはすべてを現在使用できません。
STG_E_ACCESSDENIED ストリームを開くには十分なアクセス許可がありません。
STG_E_FILENOTFOUND 指定した名前のストリームが存在しません。
STG_E_INSUFFICIENTMEMORY メモリ不足のため、ストリームが開かれていました。
STG_E_INVALIDFLAG grfMode パラメーターに指定された値が、有効な STGM 定数値ではありません。
STG_E_INVALIDFUNCTION grfMode パラメーターで指定されたフラグの組み合わせはサポートされていません。たとえば、このメソッドが STGM_SHARE_EXCLUSIVE フラグなしで呼び出された場合などです。
STG_E_INVALIDNAME pwcsName の値が無効です。
STG_E_INVALIDPOINTER ストリーム オブジェクトに指定されたポインターが無効でした。
STG_E_INVALIDPARAMETER パラメーターの 1 つが無効でした。
STG_E_REVERTED ストレージ オブジェクトは、トランザクション ツリーの上にある元に戻す操作によって無効になっています。
STG_E_TOOMANYOPENFILES 開いているファイルが多すぎるため、ストリームを開くことができませんでした。

注釈

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

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー objidl.h
Library Uuid.lib
[DLL] Ole32.dll

こちらもご覧ください

IStorage - 複合ファイルの実装

IStorage::CreateStream

Istream