IOpcFactory::CreateStreamOnFile メソッド (msopc.h)

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

ファイル上にストリームを作成します。このメソッドは、 CreateFile 関数の呼び出しの簡略化されたラッパーです。このメソッドによって公開されない CreateFile パラメーターでは、既定値が使用されます。詳細については、CreateFile のページを参照してください。

構文

HRESULT CreateStreamOnFile(
  [in]          LPCWSTR               filename,
  [in]          OPC_STREAM_IO_MODE    ioMode,
  [in]          LPSECURITY_ATTRIBUTES securityAttributes,
  [in]          DWORD                 dwFlagsAndAttributes,
  [out, retval] IStream               **stream
);

パラメーター

[in] filename

ストリームが作成されるファイルの名前。

[in] ioMode

作成するストリームの読み取り/書き込み状態を表す値。

[in] securityAttributes

このパラメーターの SECURITY_ATTRIBUTES 構造体の詳細については、 CreateFile 関数を参照してください。

[in] dwFlagsAndAttributes

ファイルの設定と属性。ほとんどのファイルでは、 FILE_ATTRIBUTE_NORMAL を使用できます。

このパラメーターの詳細については、「 CreateFile」を参照してください。

[out, retval] stream

ストリームの IStream インターフェイスへのポインター。

戻り値

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード	説明
S_OK	メソッドが成功しました。
E_INVALIDARG	ioMode パラメーターで渡される値は、有効なOPC_STREAM_IO_MODE列挙値ではありません。
E_POINTER	ファイル名パラメーターとストリームパラメーターの少なくとも 1 つが NULL です。
CreateFile 関数エラー	CreateFile 関数からの HRESULT エラーコード。

注釈

パッケージの逆シリアル化に同じストリームが使用されている場合は、ストリームを使用してパッケージデータをシリアル化しないでください。これは、この試行によって未定義の動作が発生する可能性があるためです。

パッケージの読み込みまたは保存時にこのメソッドを使用する方法については、「パッケージの読み込み」または「パッケージの保存」プログラミングタスクを参照してください。

以前の Windows バージョンでのサポート

このメソッドの動作とパフォーマンスは、サポートされているすべての Windows バージョンで同じです。詳細については、「Packaging API を使用したはじめに」および「Windows Vista 用プラットフォーム更新プログラム」を参照してください。

スレッドセーフ

パッケージ化オブジェクトはスレッドセーフではありません。

詳細については、Packaging API を使用したはじめにに関するページを参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	msopc.h