Partager via


IXpsOMObjectFactory ::CreatePackageWriterOnStream, méthode (xpsobjectmodel.h)

Ouvre un flux pour écrire le contenu d’un modèle 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 lorsque le document est écrit dans le flux.

Valeur Meaning
TRUE
Lors de l’écriture dans le flux, l’enregistreur de package tente d’optimiser le balisage pour une taille minimale.
FALSE
Lors de l’écriture dans le package, l’enregistreur de package ne tente aucune optimisation.

[in] interleaving

Spécifie si le contenu de l’om XPS est entrelacé lorsqu’il est écrit dans le flux.

[in] documentSequencePartName

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

[in] coreProperties

Interface IXpsOMCoreProperties qui contient les propriétés de document principales à 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 ignorer. 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

La méthode retourne un HRESULT. Les valeurs possibles incluent, mais ne sont pas limitées à celles de la table 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 Descriptif
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 API de document XPS n’est pas prise en charge.
 

Cette méthode appelle l’API Packaging . 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 au niveau du travail vide 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éé.

Spécifications

Requirement Valeur
Client minimum requis 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 Mise à jour de plateforme pour Windows Server 2008 [applications de bureau | Applications UWP]
plateforme cible Fenêtres
Header xpsobjectmodel.h

Voir aussi

IOpcPartUri

ISequentialStream

IXpsOMCoreProperties

IXpsOMImageResource

IXpsOMObjectFactory

IXpsOMPackageWriter

IXpsOMPrintTicketResource

Erreurs d’empaquetage

spécification de papier XML

Erreurs de document XPS