Método IXpsOMVisual::SetName (xpsobjectmodel.h)

Establece la propiedad Name del objeto visual.

Sintaxis

HRESULT SetName(
  [in] LPCWSTR name
);

Parámetros

[in] name

Nombre del objeto visual. Un puntero NULL borra la propiedad Name .

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente. Para obtener información sobre los valores devueltos de la API de documentos XPS que no aparecen en esta tabla, vea Errores del documento XPS.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
XPS_E_INVALID_NAME	Según la especificación de papel XML, la cadena que se pasa en nombre no es un nombre válido.

Comentarios

Los nombres deben ser únicos.

Si se borra la propiedad Name , se pasa un puntero NULL en name , se establece la propiedad IsHyperlinkTarget en FALSE.

Requisitos

Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	xpsobjectmodel.h

Consulte también

IXpsOMVisual

XML Paper Specification

Errores del documento XPS