Método IXpsOMDictionary::Append (xpsobjectmodel.h)

Artículo
12/22/2023

Anexa una interfaz IXpsOMShareable junto con su clave al final del diccionario.

Sintaxis

HRESULT Append(
  [in] LPCWSTR         key,
  [in] IXpsOMShareable *entry
);

Parámetros

[in] key

Clave que se va a usar para esta entrada.

La cadena a la que hace referencia la clave debe ser única en el diccionario.

[in] entry

Puntero a la interfaz IXpsOMShareable que se va a anexar al diccionario.

Un diccionario no puede contener punteros de interfaz duplicados. Este parámetro debe contener un puntero de interfaz que aún no está en el diccionario.

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_NO_CUSTOM_OBJECTS	entry no apunta a una implementación de interfaz reconocida. No se admite la implementación personalizada de interfaces de LA API de documentos XPS.

Comentarios

Los punteros de interfaz almacenados en un diccionario suelen apuntar a interfaces, como IXpsOMBrush e IXpsOMVisual, que se derivan de la interfaz IXpsOMShareable . Para determinar el tipo de interfaz, llame al método IXpsOMShareable::GetType .

En la ilustración siguiente se muestra cómo cambia el diccionario el método Append .

Ilustración que muestra cómo Append agrega una entrada al diccionario

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