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

Article
03/13/2024

Ouvre un flux permettant d’écrire le contenu d’un objet objet XPS dans un package XPS.

Syntaxe

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
);

Paramètres

[in] outputStream

Flux à utiliser pour l’écriture.

[in] optimizeMarkupSize

Valeur booléenne qui indique si le balisage du document sera optimisé pour la taille lors de l’écriture du document dans le flux.

Valeur	Signification
VRAI	Lors de l’écriture dans le flux, l’enregistreur de package tente d’optimiser le balisage pour la taille minimale.
FAUX	Lors de l’écriture dans le package, l’enregistreur de package ne tente pas d’optimisation.

[in] interleaving

Spécifie si le contenu du modèle objet XPS sera entrelacé lors de son écriture dans le flux.

[in] documentSequencePartName

Interface IOpcPartUri qui contient le nom de la partie de la séquence de document dans le nouveau fichier.

[in] coreProperties

Interface IXpsOMCoreProperties qui contient les principales propriétés du document à attribuer au nouveau fichier. Ce paramètre peut être défini sur NULL.

[in] packageThumbnail

Interface IXpsOMImageResource qui contient l’image miniature à affecter au nouveau fichier. Ce paramètre peut être défini sur NULL.

[in] documentSequencePrintTicket

Interface IXpsOMPrintTicketResource qui contient le ticket d’impression au niveau du package à affecter au nouveau fichier. Ce paramètre peut être défini sur NULL.

[in] discardControlPartName

Interface IOpcPartUri qui contient le nom de la partie de contrôle d’abandon. Ce paramètre peut être défini sur NULL.

[out, retval] packageWriter

Pointeur vers la nouvelle interface IXpsOMPackageWriter créée par cette méthode.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles incluent, sans s’y limiter, celles du tableau qui suit. Pour plus d’informations sur les valeurs de retour de l’API de document XPS qui ne sont pas répertoriées dans ce tableau, consultez Erreurs de document XPS.

Code de retour	Description
S_OK	S_OK
E_POINTER	outputStream, documentSequencePartName ou packageWriter a la valeur NULL.
XPS_E_NO_CUSTOM_OBJECTS	coreProperties, documentSequencePrintTicket ou packageThumbnail ne pointe pas vers une implémentation d’interface reconnue. L’implémentation personnalisée des interfaces d’API document XPS n’est pas prise en charge.

Cette méthode appelle l’API d’empaquetage . Pour plus d’informations sur les valeurs de retour de l’API d’empaquetage, consultez Erreurs d’empaquetage.

Remarques

Le flux est ouvert et initialisé, puis l’interface IXpsOMPackageWriter retournée est utilisée pour écrire des types de contenu, des relations de package, des propriétés principales, des ressources de séquence de documents et des relations de séquence de documents.

Si documentSequencePrintTicket a la valeur NULL et que la valeur de l’entrelacement est XPS_INTERLEAVING_ON, cette méthode crée un ticket d’impression vide au niveau du travail et ajoute une relation au ticket d’impression vide. Cela permet de fournir une consommation de streaming plus efficace du package.

Si documentSequencePrintTicket a la valeur NULL et que la valeur de l’entrelacement est XPS_INTERLEAVING_OFF, aucun ticket d’impression vide n’est créé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	xpsobjectmodel.h