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

Ouvre un flux qui contient un package XPS et retourne une arborescence d’objets de document XPS instanciée.

Syntaxe

HRESULT CreatePackageFromStream(
  [in]          IStream       *stream,
  [in]          BOOL          reuseObjects,
  [out, retval] IXpsOMPackage **package
);

Paramètres

[in] stream

Flux qui contient un package XPS.

[in] reuseObjects

Valeur booléenne qui indique que le logiciel tente d’optimiser l’arborescence d’objets de document en partageant des objets identiques dans toutes les propriétés et enfants.

[out, retval] package

Pointeur vers la nouvelle interface IXpsOMPackage qui contient l’arborescence d’objets de document XPS résultante.

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.

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

Cette méthode ne valide pas le contenu des ressources basées sur un flux qu’elle charge à partir du flux dans les objets de l’om XPS. Au lieu de cela, l’application doit valider ces ressources avant de les utiliser.

Cette méthode ne désérialise pas les pages de document ; il désérialise uniquement le package XPS jusqu’aux parties de référence de page. Les pages réelles peuvent être désérialisées à mesure qu’elles sont nécessaires, en appelant la méthode IXpsOMPageReference ::GetPage . Étant donné que les pages ne sont pas désérialisées lorsque GetPage est appelé, il est possible que cette méthode retourne S_OK ou, si une tentative est effectuée pour charger une page problématique dans un package XPS, pour renvoyer une erreur.

Si vous écrivez un om XPS immédiatement après avoir lu un package XPS, certains contenus d’origine peuvent être perdus ou modifiés.

Certaines des modifications qui peuvent se produire dans ce cas sont répertoriées dans le tableau suivant :

Pour plus d’informations sur l’utilisation de l’interface IXpsOMPackage dans un programme, consultez Créer un om XPS vide.

Spécifications

Voir aussi

Créer un om XPS vide

IXpsOMObjectFactory

IXpsOMPackage

Erreurs d’empaquetage

spécification de papier XML

Erreurs de document XPS