Méthode IXpsOMPage ::SetName (xpsobjectmodel.h)

Définit la propriété Name de cette page.

Syntaxe

HRESULT SetName(
  [in] LPCWSTR name
);

Paramètres

[in] name

Pointeur vers la chaîne de nom à définir comme propriété Name de la page. Un pointeur NULL efface tout nom précédemment attribué.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles incluent, sans s’y limiter, 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	Description
S_OK	S_OK
XPS_E_INVALID_NAME	La chaîne de nom contient un caractère qui n’est pas valide.

Remarques

La propriété Name identifie la page active en tant que point nommé et adressable dans un document, ce qui permet à la page d’être référencée par un lien hypertexte.

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 Mise à jour de plateforme pour Windows Server 2008 [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	xpsobjectmodel.h

Voir aussi

IXpsOMPage

XML Paper Specification

Erreurs de document XPS