Método IXpsOMObjectFactory::CreatePackageWriterOnStream (xpsobjectmodel.h)

Artigo
08/28/2023

Abre um fluxo para gravar o conteúdo de um OM XPS em um pacote XPS.

Sintaxe

HRESULT CreatePackageWriterOnStream(
  [in]          ISequentialStream         *outputStream,
  [in]          BOOL                      optimizeMarkupSize,
  [in]          XPS_INTERLEAVING          interleaving,
  [in]          IOpcPartUri               *documentSequencePartName,
  [in]          IXpsOMCoreProperties      *coreProperties,
  [in]          IXpsOMImageResource       *packageThumbnail,
  [in]          IXpsOMPrintTicketResource *documentSequencePrintTicket,
  [in]          IOpcPartUri               *discardControlPartName,
  [out, retval] IXpsOMPackageWriter       **packageWriter
);

Parâmetros

[in] outputStream

O fluxo a ser usado para gravação.

[in] optimizeMarkupSize

Um valor booliano que indica se a marcação do documento será otimizada para tamanho quando o documento for gravado no fluxo.

Valor	Significado
VERDADE	Ao gravar no fluxo, o gravador de pacote tentará otimizar a marcação para o tamanho mínimo.
FALSE	Ao gravar no pacote, o gravador de pacote não tentará nenhuma otimização.

[in] interleaving

Especifica se o conteúdo do OM XPS será intercalado quando for gravado no fluxo.

[in] documentSequencePartName

A interface IOpcPartUri que contém o nome da parte da sequência de documentos no novo arquivo.

[in] coreProperties

A interface IXpsOMCoreProperties que contém as principais propriedades do documento a serem fornecidas ao novo arquivo. Esse parâmetro pode ser definido como NULL.

[in] packageThumbnail

A interface IXpsOMImageResource que contém a imagem em miniatura a ser atribuída ao novo arquivo. Esse parâmetro pode ser definido como NULL.

[in] documentSequencePrintTicket

A interface IXpsOMPrintTicketResource que contém o tíquete de impressão no nível do pacote a ser atribuído ao novo arquivo. Esse parâmetro pode ser definido como NULL.

[in] discardControlPartName

A interface IOpcPartUri que contém o nome da parte de controle de descarte. Esse parâmetro pode ser definido como NULL.

[out, retval] packageWriter

Um ponteiro para a nova interface IXpsOMPackageWriter criada por esse método.

Retornar valor

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir. Para obter informações sobre valores retornados da API de documento XPS que não estão listados nesta tabela, consulte Erros de documento XPS.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	outputStream, documentSequencePartName ou packageWriter é NULL.
XPS_E_NO_CUSTOM_OBJECTS	coreProperties, documentSequencePrintTicket ou packageThumbnail não aponta para uma implementação de interface reconhecida. Não há suporte para a implementação personalizada de interfaces de API de Documento XPS.

Esse método chama a API de Empacotamento . Para obter informações sobre os valores retornados da API de Empacotamento, consulte Erros de empacotamento.

Comentários

O fluxo é aberto e inicializado e, em seguida, a interface IXpsOMPackageWriter retornada é usada para gravar tipos de conteúdo, relações de pacote, propriedades principais, recursos de sequência de documentos e relações de sequência de documentos.

Se documentSequencePrintTicket estiver definido como NULL e o valor da intercalação for XPS_INTERLEAVING_ON, esse método criará um tíquete de impressão em branco no nível do trabalho e adicionará uma relação ao tíquete de impressão em branco. Isso é feito para fornecer um consumo de streaming mais eficiente do pacote.

Se documentSequencePrintTicket estiver definido como NULL e o valor da intercalação for XPS_INTERLEAVING_OFF, nenhum tíquete de impressão em branco será criado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	xpsobjectmodel.h