IXpsOMVisual::SetName-Methode (xpsobjectmodel.h)
Legt die Name-Eigenschaft des Visuals fest.
Syntax
HRESULT SetName(
[in] LPCWSTR name
);
Parameter
[in] name
Der Name des Visuals. Ein NULL-Zeiger löscht die Name-Eigenschaft .
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem die Werte in der folgenden Tabelle. Informationen zu XPS-Dokument-API-Rückgabewerten, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS-Dokumentfehler.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Gemäß der XML-Papierspezifikation ist die im Namen übergebene Zeichenfolge kein gültiger Name. |
Hinweise
Namen müssen eindeutig sein.
Durch Löschen der Name-Eigenschaft durch Übergeben eines NULL-Zeigers im Namen wird die IsHyperlinkTarget-Eigenschaft auf FALSE festgelegt.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | xpsobjectmodel.h |