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

[アーティクル]
08/25/2023

ストリームからパッケージデータを逆シリアル化し、読み取るパッケージを表すパッケージオブジェクトを作成します。パッケージオブジェクトまたはパッケージオブジェクト自体から取得した Packaging API オブジェクトがまだ使用されていますが、ストリームを使用してパッケージデータにアクセスできます。

構文

HRESULT ReadPackageFromStream(
  [in]          IStream        *stream,
  [in]          OPC_READ_FLAGS flags,
  [out, retval] IOpcPackage    **package
);

パラメーター

[in] stream

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

ストリームは読み取り可能、シーク可能、サイズ、パッケージデータを含む必要があります。さらに、ストリームが複製できない場合は、バッファーに格納され、順番に読み取られ、オーバーヘッドが発生します。

[in] flags

パッケージコンポーネントをキャッシュし、 OPC 準拠の要件に照らして検証するための読み取り設定を指定する値。

[out, retval] package

ストリームを介して読み取られるパッケージを表すパッケージオブジェクトの IOpcPackage インターフェイスへのポインター。

戻り値

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

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

注釈

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

パッケージ化 API は、OPC で指定された ZIP アーカイブをマップするパッケージと対話でき、Zip32 (ZIP 2.0) または Zip64 (ZIP 4.5) エンコードに基づいています。

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

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

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

スレッドセーフ

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

詳細については、「Packaging API を使用したはじめに」を参照してください。

要件

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