Freigeben über


IXpsOMPage::SetName-Methode (xpsobjectmodel.h)

Legt die Name-Eigenschaft dieser Seite fest.

Syntax

HRESULT SetName(
  [in] LPCWSTR name
);

Parameter

[in] name

Ein Zeiger auf die Namenszeichenfolge, die als Name-Eigenschaft der Seite festgelegt werden soll. Ein NULL-Zeiger löscht alle zuvor zugewiesenen Namen.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem diejenigen in der folgenden Tabelle. Informationen zu Rückgabewerten der XPS-Dokument-API, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS-Dokumentfehler.

Rückgabecode BESCHREIBUNG
S_OK
Die Methode wurde erfolgreich ausgeführt.
XPS_E_INVALID_NAME
Die Namenszeichenfolge enthält ein ungültiges Zeichen.

Hinweise

Die Name-Eigenschaft identifiziert die aktuelle Seite als benannten, adressierbaren Punkt in einem Dokument, sodass durch einen Link auf die Seite verwiesen werden kann.

Anforderungen

Anforderung Wert
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

Weitere Informationen

IXpsOMPage

XML Paper Specification

XPS-Dokumentfehler