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

Artigo
08/25/2023

Serializa um pacote que é representado por um objeto de pacote.

Sintaxe

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

Parâmetros

[in] package

Um ponteiro para a interface IOpcPackage do objeto de pacote que contém dados a serem serializados.

[in] flags

O valor que descreve o método de codificação usado na serialização.

[in] stream

Um ponteiro para a interface IStream do fluxo em que os dados do objeto do pacote serão gravados.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	O valor passado no parâmetro flags não é válido OPC_WRITE_FLAGS valor de enumeração.
E_NOTIMPL	Esse método não é implementado para esta versão do Windows.
E_POINTER	Pelo menos um dos parâmetros de fluxo e pacote é NULL.
Erro de interface IStream	Um código de erro HRESULT da interface IStream .
Erro de consumo de pacote	Um código de erro HRESULT do Grupo de Erros de Consumo de Pacote.
Erro de parte do URI	Um código de erro HRESULT do Grupo de Erros do URI da Parte.

Comentários

Não use um fluxo para serializar dados de pacote quando o mesmo fluxo estiver sendo usado para desserializar um pacote, pois a tentativa pode resultar em um comportamento indefinido.

Para obter informações sobre como usar esse método para salvar um pacote que é representado como um objeto de pacote, consulte a tarefa de programação Salvar um pacote .

Suporte em versões anteriores do Windows

Não há suporte para esse método em versões do Windows anteriores ao Windows 7. Para obter mais informações, consulte Introdução com a API de Empacotamento e Atualização de Plataforma para Windows Vista.

Acesso thread-safe

Os objetos de empacotamento não são thread-safe.

Para obter mais informações, consulte o Introdução com a API de Empacotamento.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msopc.h