次の方法で共有


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

ファイル上にストリームを作成します。 このメソッドは、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 関数エラー
HRESULTCreateFile 関数のエラー コードです。

備考

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

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

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

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

スレッド セーフ

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

詳細については、「パッケージ化 APIの の概要」を参照してください。

必要条件

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

関連項目

CreateFile の

ECMA-376 OpenXML

外部リソース の

Packaging API の概要

IOpcFactory の

パッケージ の読み込みの

OPC_STREAM_IO_MODE

の概要

Packaging API プログラミング ガイド

Packaging API リファレンス

Packaging API サンプル

パッケージ化エラーの を する

パーツの概要

Windows Vista 用プラットフォーム更新プログラムの

RFC 3986: URI ジェネリック構文

リファレンス

パッケージ の保存の