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

パッケージオブジェクトによって表されるパッケージをシリアル化します。

構文

HRESULT WritePackageToStream(
  [in] IOpcPackage     *package,
  [in] OPC_WRITE_FLAGS flags,
  [in] IStream         *stream
);

[in] package

シリアル化するデータを含むパッケージオブジェクトの IOpcPackage インターフェイスへのポインター。

[in] flags

シリアル化で使用されるエンコードメソッドを表す値。

[in] stream

パッケージオブジェクトデータが書き込まれるストリームの IStream インターフェイスへのポインター。

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

リターンコード	説明
S_OK	メソッドが成功しました。
E_INVALIDARG	flags パラメーターで渡される値は、有効なOPC_WRITE_FLAGS列挙値ではありません。
E_NOTIMPL	このメソッドは、このバージョンの Windows では実装されていません。
E_POINTER	ストリームおよびパッケージパラメーターの少なくとも 1 つが NULL です。
IStream インターフェイスエラー	IStream インターフェイスからの HRESULT エラーコード。
パッケージの使用エラー	パッケージ消費エラーグループの HRESULT エラーコード。
パーツ URI エラー	パーツ URI エラーグループからの HRESULT エラーコード。

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

このメソッドを使用してパッケージオブジェクトとして表されるパッケージを保存する方法については、「パッケージの保存」プログラミングタスクを参照してください。

この方法は、Windows 7 より前のバージョンの Windows ではサポートされていません。詳細については、「Packaging API を使用したはじめに」および「Windows Vista 用プラットフォーム更新プログラム」を参照してください。

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

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	msopc.h