Partager via

IXpsOMPackage ::WriteToFile, méthode (xpsobjectmodel.h)

Écrit le package XPS dans un fichier spécifié.

Syntaxe

HRESULT WriteToFile(
  [in] LPCWSTR               fileName,
  [in] LPSECURITY_ATTRIBUTES securityAttributes,
  [in] DWORD                 flagsAndAttributes,
  [in] BOOL                  optimizeMarkupSize
);

Paramètres

[in] fileName

Nom du fichier à créer. Ce paramètre ne doit pas être NULL.

[in] securityAttributes

Structure SECURITY_ATTRIBUTES , qui contient deux membres de données distincts mais associés :

  • 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, le fichier ou l’appareil associé au handle retourné reçoit un descripteur de sécurité par défaut.

Pour plus d’informations sur le paramètre securityAttributes , reportez-vous à CreateFile.

[in] flagsAndAttributes

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

Pour plus d’informations sur le paramètre flagsAndAttributes , reportez-vous à CreateFile.

[in] optimizeMarkupSize

Valeur booléenne qui indique si le balisage du document doit être optimisé pour la taille lorsqu’il est écrit dans le fichier.

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

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
 fileName est NULL.
 

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

La valeur optimizeMarkupSize détermine si le balisage à l’intérieur des parties de document individuelles doit être optimisé. Elle n’a aucun effet sur la façon dont les parties sont entrelacées.

Note L’écriture d’un MODÈLE XPS dans un fichier ne crée pas automatiquement une miniature pour le document XPS. Pour créer une miniature du document XPS, utilisez l’interface IXpsOMThumbnailGenerator .
 

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

CreateFile

IXpsOMPackage

Erreurs d’empaquetage

SECURITY_ATTRIBUTES

spécification de papier XML

Erreurs de document XPS

  • Last updated on