IOpcFactory::ReadPackageFromStream-Methode (msopc.h)

Artikel
03/04/2024

Deserialisiert Paketdaten aus einem Stream und erstellt ein Paketobjekt, das das zu lesende Paket darstellt. Während ein aus dem Paketobjekt oder dem Paketobjekt selbst abgerufenes Packaging-API-Objekt weiterhin verwendet wird, kann der Stream für den Zugriff auf Paketdaten verwendet werden.

Syntax

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

Parameter

[in] stream

Ein Zeiger auf die IStream-Schnittstelle des Streams.

Der Stream muss lesbar, suchbar, groß sein und Paketdaten enthalten. Wenn der Stream nicht geklont werden kann, wird er außerdem gepuffert und sequenziell gelesen, was zu Mehraufwand führt.

[in] flags

Der Wert, der die Leseeinstellungen für das Zwischenspeichern von Paketkomponenten und deren Überprüfung anhand der OPC-Konformitätsanforderungen angibt.

[out, retval] package

Ein Zeiger auf die IOpcPackage-Schnittstelle des Paketobjekts, das das Paket darstellt, das durch den Stream gelesen wird.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG	Der im Flags-Parameter übergebene Wert ist kein gültiger OPC_READ_FLAGS Enumerationswert.
E_NOTIMPL	Diese Methode ist für diese Version von Windows nicht implementiert.
E_POINTER	Mindestens einer der Stream- und Paketparameter ist NULL.
IStream-Schnittstellenfehler	Ein HRESULT-Fehlercode von der IStream-Schnittstelle .
Fehler "Paketverbrauch"	Ein HRESULT-Fehlercode aus der Fehlergruppe Paketverbrauch.
Part-URI-Fehler	Ein HRESULT-Fehlercode aus der Part-URI-Fehlergruppe.

Hinweise

Verwenden Sie keinen Stream, um Paketdaten zu serialisieren, wenn derselbe Stream zum Deserialisieren eines Pakets verwendet wird, da der Versuch zu einem nicht definierten Verhalten führen kann.

Die Paketerstellungs-APIs können mit Paketen interagieren, die ein ZIP-Archiv zuordnen, wie im OPC angegeben, und die entweder auf zip32 -Codierung (ZIP 2.0) oder Zip64 (ZIP 4.5) basieren.

Informationen zum Laden eines Pakets mit dieser Methode finden Sie unter Laden eines Pakets .

Unterstützung für frühere Windows-Versionen

Diese Methode wird in Windows-Versionen vor Windows 7 nicht unterstützt. Weitere Informationen finden Sie unter Erste Schritte mit der Verpackungs-API und Platform Update für Windows Vista.

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie im Erste Schritte mit der Verpackungs-API.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msopc.h