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

Artículo
02/29/2024

Serializa un paquete representado por un objeto de paquete.

Sintaxis

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

Parámetros

[in] package

Puntero a la interfaz IOpcPackage del objeto de paquete que contiene datos que se van a serializar.

[in] flags

Valor que describe el método de codificación utilizado en la serialización.

[in] stream

Puntero a la interfaz IStream de la secuencia donde se escribirán los datos del objeto del paquete.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_INVALIDARG	El valor pasado en el parámetro flags no es un valor de enumeración OPC_WRITE_FLAGS válido.
E_NOTIMPL	Este método no se implementa para esta versión de Windows.
E_POINTER	Al menos uno de los parámetros de flujo y paquete es NULL.
Error de la interfaz IStream	Código de error HRESULT de la interfaz IStream .
Error de consumo de paquetes	Código de error HRESULT del grupo de errores de consumo de paquetes.
Error de URI de parte	Código de error HRESULT del grupo de errores del URI de parte.

Comentarios

No use una secuencia para serializar los datos del paquete cuando se use la misma secuencia para deserializar un paquete, ya que el intento puede dar lugar a un comportamiento indefinido.

Para obtener información sobre cómo usar este método para guardar un paquete representado como un objeto de paquete, vea la tarea Guardar un paquete de programación.

Compatibilidad con versiones anteriores de Windows

Este método no se admite en versiones de Windows anteriores a Windows 7. Para obtener más información, consulte Introducción con packaging API y Platform Update para Windows Vista.

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para obtener más información, consulte el Introducción con packaging API.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msopc.h