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

Article
11/20/2024

Ouvre un fichier pour écrire le contenu d’un modèle XPS dans un package XPS d’un type spécifié. Cette méthode produit un enregistreur de package pour un document MSXPS ou un document OpenXPS.

Syntaxe

HRESULT CreatePackageWriterOnFile1(
  LPCWSTR                   fileName,
  LPSECURITY_ATTRIBUTES     securityAttributes,
  DWORD                     flagsAndAttributes,
  BOOL                      optimizeMarkupSize,
  XPS_INTERLEAVING          interleaving,
  IOpcPartUri               *documentSequencePartName,
  IXpsOMCoreProperties      *coreProperties,
  IXpsOMImageResource       *packageThumbnail,
  IXpsOMPrintTicketResource *documentSequencePrintTicket,
  IOpcPartUri               *discardControlPartName,
  XPS_DOCUMENT_TYPE         documentType,
  IXpsOMPackageWriter       **packageWriter
);

Paramètres

fileName

[in] Nom du fichier à créer.

securityAttributes

[in, unique] Structure SECURITY_ATTRIBUTES, qui contient deux membres distincts mais connexes :

lpSecurityDescriptor: un descripteur de sécurité facultatif
bInheritHandle: valeur booléenne qui détermine si le handle retourné peut être hérité par les processus enfants

Si lpSecurityDescriptor est NULL, le fichier ou l’appareil associé au handle retourné reçoit un descripteur de sécurité par défaut.

Pour plus d’informations sur securityAttributes, consultez CreateFile.

flagsAndAttributes

[in] Spécifie les paramètres et les attributs du fichier à créer. Pour la plupart des fichiers, la valeur FILE_ATTRIBUTE_NORMAL peut être utilisée.

Pour plus d’informations sur ce paramètre, consultez CreateFile.

optimizeMarkupSize

[in] Valeur booléenne qui indique si le balisage du document sera optimisé pour la taille lorsque le contenu du modèle XPS est écrit dans le package XPS.

Valeur	Signification
TRUE	L’enregistreur de package tente d’optimiser le balisage pour une taille minimale.
FALSE	L’enregistreur de package n’essaie pas d’effectuer d’optimisation.

interleaving

[in] Spécifie si le contenu de l’om XPS est entrelacé lorsqu’il est écrit dans le fichier.

documentSequencePartName

[in] L’interface IOpcPartUri qui contient le nom de la partie de la séquence de documents dans le nouveau fichier.

coreProperties

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

packageThumbnail

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

documentSequencePrintTicket

[in] L’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] L’interface IOpcPartUri qui contient le nom du composant de contrôle ignorer. Ce paramètre peut être défini sur NULL .

documentType

[in] Spécifie le 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 de retour

Les valeurs possibles incluent, mais ne sont pas limitées à, 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éfinie.

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. CreatePackageWriterOnFile, publiée dans Windows 7, crée uniquement des fichiers de documents XPS au format MSXPS.

références supplémentaires

Références supplémentaires : description de la méthode héritée

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8 [applications de bureau \| Applications UWP]
serveur minimum pris en charge	Windows Server 2012 [applications de bureau \| Applications UWP]
plateforme cible	Windows
d’en-tête	xpsobjectmodel_1.h
bibliothèque	Aucun

Voir aussi

IXpsOMObjectFactory1

Partager via