Méthode IXpsOMPackageWriter ::AddResource (xpsobjectmodel.h)

Article
08/28/2023

Crée une ressource de composant dans le package.

Syntaxe

HRESULT AddResource(
  [in] IXpsOMResource *resource
);

Paramètres

[in] resource

Interface IXpsOMResource de la ressource de composant qui sera ajoutée en tant que nouvelle partie dans le package. Consultez Remarques pour connaître les types de ressources qui peuvent être passés dans ce paramètre.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles incluent, sans s’y limiter, celles du tableau 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	Description
S_OK	S_OK
E_INVALIDARG	Une ressource portant le même nom que la ressource référencée par la ressource a déjà été ajoutée au flux ou aucune relation n’inclut la ressource référencée par la ressource. Une fois E_INVALIDARG retournée, le flux ou le fichier n’est plus valide et Close retourne XPS_E_UNAVAILABLE_PACKAGE.
XPS_E_UNAVAILABLE_PACKAGE	Une erreur grave s’est produite et le contenu de l’objet XPS peut être irrécupérable. Certains composants du modèle modèle XPS peuvent toujours être utilisables, mais seulement après leur vérification. Étant donné que l’état du modèle modèle XPS ne peut pas être prédit après le retour de cette erreur, tous les composants du modèle modèle XPS doivent être libérés et ignorés.

Cette méthode appelle l’API d’empaquetage . Pour plus d’informations sur les valeurs de retour de l’API d’empaquetage, consultez Erreurs d’empaquetage.

Remarques

Cette méthode crée un composant dans le package de documents qui correspond à la ressource, ajoute le contenu de la ressource au nouveau composant, puis ferme le nouveau composant.

Si cette méthode retourne une erreur, l’enregistreur de package n’est plus utilisable.

Le paramètre de ressource doit être l’un des éléments suivants :

Interface IXpsOMFontResource d’une ressource de police utilisée dans la page active ou d’une page qui a déjà été ajoutée.
Interface IXpsOMImageResource d’une ressource image utilisée dans la page active ou d’une page qui a déjà été ajoutée.
Interface IXpsOMColorProfileResource de la ressource de profil de couleur utilisée dans la page active ou une page qui a déjà été ajoutée.
Interface IXpsOMStoryFragmentsResource d’une ressource de fragments d’article utilisée dans la page active ou d’une page qui a déjà été ajoutée.
Interface IXpsOMDocumentStructureResource d’une ressource de structure de document utilisée dans le document actif ou d’un document qui a déjà été ajouté.
Interface IXpsOMSignatureBlockResource d’une ressource de bloc de signature utilisée dans le document actif ou d’un document qui a déjà été ajouté.

Cette méthode retourne une erreur si la ressource contient l’un des éléments suivants :

Interface IXpsOMRemoteDictionaryResource d’un dictionnaire de ressources distant.
Interface IXpsOMPrintTicketResource d’un ticket d’impression.
Interface IXpsOMImageResource d’une image miniature.

Cette méthode retourne une erreur lorsque la ressource fait référence à une ressource portant le même nom qu’une ressource qui a déjà été ajoutée au flux ou pour laquelle il n’existe aucune relation.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	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 Platform Update pour Windows Server 2008 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	xpsobjectmodel.h