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

Article
03/13/2024

Ouvre un fichier pour l’écriture du contenu d’un objet 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] La structure SECURITY_ATTRIBUTES , qui contient deux membres distincts mais connexes :

lpSecurityDescriptor : 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 a la valeur NULL, un descripteur de sécurité par défaut est affecté au fichier ou à l’appareil associé au handle retourné.

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 objet XPS sera écrit dans le package XPS.

Valeur	Signification
VRAI	L’enregistreur de package essaiera d’optimiser le balisage pour une taille minimale.
FAUX	L’enregistreur de package ne tente pas d’effectuer d’optimisation.

interleaving

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

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] Spécifie le type de document du writer 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. CreatePackageWriterOnFile, publié dans Windows 7, crée uniquement des fichiers de document XPS au format MSXPS.

Références supplémentaires

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

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