Méthode IOpcFactory ::WritePackageToStream (msopc.h)

Article
08/25/2023

Sérialise un package représenté par un objet de package.

Syntaxe

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

Paramètres

[in] package

Pointeur vers l’interface IOpcPackage de l’objet package qui contient des données à sérialiser.

[in] flags

Valeur qui décrit la méthode d’encodage utilisée dans la sérialisation.

[in] stream

Pointeur vers l’interface IStream du flux où les données de l’objet de package seront écrites.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
E_INVALIDARG	La valeur transmise dans le paramètre flags n’est pas une valeur d’énumération OPC_WRITE_FLAGS valide.
E_NOTIMPL	Cette méthode n’est pas implémentée pour cette version de Windows.
E_POINTER	Au moins un des paramètres de flux et de package est NULL.
Erreur d’interface IStream	Code d’erreur HRESULT de l’interface IStream .
Erreur de consommation de package	Code d’erreur HRESULT du groupe d’erreurs de consommation de package.
Erreur d’URI de partie	Code d’erreur HRESULT du groupe d’erreurs d’URI de partie.

Remarques

N’utilisez pas de flux pour sérialiser des données de package lorsque le même flux est utilisé pour désérialiser un package, car la tentative peut entraîner un comportement non défini.

Pour plus d’informations sur l’utilisation de cette méthode pour enregistrer un package représenté en tant qu’objet de package, consultez la tâche de programmation Enregistrement d’un package .

Prise en charge sur les versions précédentes de Windows

Cette méthode n’est pas prise en charge sur les versions de Windows antérieures à Windows 7. Pour plus d’informations, consultez Prise en main avec l’API d’empaquetage et Mise à jour de plateforme pour Windows Vista.

Cohérence de thread

Les objets d’empaquetage ne sont pas thread-safe.

Pour plus d’informations, consultez la Prise en main avec l’API Packaging.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	msopc.h