IOpcFactory::WritePackageToStream-Methode (msopc.h)

Artikel
02/29/2024

Serialisiert ein Paket, das durch ein Paketobjekt dargestellt wird.

Syntax

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

Parameter

[in] package

Ein Zeiger auf die IOpcPackage-Schnittstelle des Paketobjekts, das die zu serialisierenden Daten enthält.

[in] flags

Der Wert, der die in der Serialisierung verwendete Codierungsmethode beschreibt.

[in] stream

Ein Zeiger auf die IStream-Schnittstelle des Datenstroms, in den die Paketobjektdaten geschrieben werden.

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_WRITE_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.

Informationen zum Speichern eines Pakets, das als Paketobjekt dargestellt wird, finden Sie unter Speichern eines Pakets mit dieser Methode.

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