Méthode IXpsOMObjectFactory1 ::CreatePackageWriterOnStream1 (xpsobjectmodel_1.h)

Article
08/28/2023

Ouvre un flux pour écrire le contenu d’un objet XPS dans un package XPS d’un type spécifié.

Syntaxe

HRESULT CreatePackageWriterOnStream1(
  ISequentialStream         *outputStream,
  BOOL                      optimizeMarkupSize,
  XPS_INTERLEAVING          interleaving,
  IOpcPartUri               *documentSequencePartName,
  IXpsOMCoreProperties      *coreProperties,
  IXpsOMImageResource       *packageThumbnail,
  IXpsOMPrintTicketResource *documentSequencePrintTicket,
  IOpcPartUri               *discardControlPartName,
  XPS_DOCUMENT_TYPE         documentType,
  IXpsOMPackageWriter       **packageWriter
);

Paramètres

outputStream

[in] Flux à utiliser pour l’écriture.

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.

interleaving

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

documentSequencePartName

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

coreProperties

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

packageThumbnail

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

documentSequencePrintTicket

[in] 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.

discardControlPartName

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

documentType

[in] Type de document de l’enregistreur de package. La valeur de ce paramètre ne peut pas être XPS_DOCUMENT_TYPE_UNSPECIFIED.

packageWriter

[out, retval] Pointeur vers la nouvelle interface IXpsOMPackageWriter créée par cette méthode.

Valeur retournée

Les valeurs possibles incluent, sans s’y limiter, les éléments suivants. Pour plus d’informations sur les valeurs de retour de l’API de document XPS qui ne sont pas répertoriées ici, consultez Erreurs de document XPS.

S_OK : la méthode a réussi et packageWriter a été correctement défini.

E_INVALIDARG : le type de document n’était pas un format de document XPS valide.

Remarques

Utilisez cette méthode pour produire un enregistreur de package pour un document MSXPS ou un document OpenXPS. CreatePackageWriterOnStream, publié dans Windows 7, crée uniquement des fichiers de document XPS au format MSXPS.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	xpsobjectmodel_1.h
Bibliothèque	None

Voir aussi

IXpsOMObjectFactory1

Partager via