Método IXpsOMObjectFactory::CreatePackageWriterOnStream (xpsobjectmodel.h)
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 |
|---|---|
|
Ao gravar no fluxo, o gravador de pacote tentará otimizar a marcação para o tamanho mínimo. |
|
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 |
|---|---|
|
O método foi bem-sucedido. |
|
outputStream, documentSequencePartName ou packageWriter é NULL. |
|
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 |