Método IXpsOMPackageWriter::AddResource (xpsobjectmodel.h)

Artículo
03/13/2024

Crea un nuevo recurso de elemento en el paquete.

Sintaxis

HRESULT AddResource(
  [in] IXpsOMResource *resource
);

Parámetros

[in] resource

Interfaz IXpsOMResource del recurso de elemento que se agregará como una nueva parte del paquete. Vea Comentarios sobre los tipos de recursos que se pueden pasar en este parámetro.

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.
E_INVALIDARG	Un recurso con el mismo nombre que el recurso al que hace referencia el recurso ya se ha agregado a la secuencia o no hay ninguna relación que incluya el recurso al que hace referencia el recurso. Después de devolver E_INVALIDARG , la secuencia o el archivo ya no son válidos y Close devolverá XPS_E_UNAVAILABLE_PACKAGE.
XPS_E_UNAVAILABLE_PACKAGE	Se ha producido un error grave y el contenido del OM XPS podría ser irrecuperable. Algunos componentes del XPS OM pueden seguir siendo utilizables, pero solo después de que se hayan comprobado. Dado que el estado del OM XPS no se puede predecir después de que se devuelva este error, todos los componentes del OM XPS deben liberarse y descartarse.

Este método llama a la API de empaquetado . Para obtener información sobre los valores devueltos de la API de empaquetado, consulte Errores de empaquetado.

Comentarios

Este método crea un nuevo elemento en el paquete de documentos que corresponde al recurso, agrega el contenido del recurso a la nueva parte y, a continuación, cierra la nueva parte.

Si este método devuelve un error, el escritor de paquetes ya no se puede usar.

El parámetro resource debe ser uno de los siguientes:

Interfaz IXpsOMFontResource de un recurso de fuente que se usa en la página actual o en una página que ya se ha agregado.
Interfaz IXpsOMImageResource de un recurso de imagen que se usa en la página actual o en una página que ya se ha agregado.
Interfaz IXpsOMColorProfileResource del recurso de perfil de color que se usa en la página actual o en una página que ya se ha agregado.
Interfaz IXpsOMStoryFragmentsResource de un recurso de fragmentos de artículo que se usa en la página actual o en una página que ya se ha agregado.
Interfaz IXpsOMDocumentStructureResource de un recurso de estructura de documento que se usa en el documento actual o en un documento que ya se ha agregado.
Interfaz IXpsOMSignatureBlockResource de un recurso de bloque de firma que se usa en el documento actual o en un documento que ya se ha agregado.

Este método devuelve un error si el recurso contiene uno de los siguientes elementos:

Interfaz IXpsOMRemoteDictionaryResource de un diccionario de recursos remotos.
Interfaz IXpsOMPrintTicketResource de un vale de impresión.
Interfaz IXpsOMImageResource de una imagen en miniatura.

Este método devuelve un error cuando el recurso hace referencia a un recurso que tiene el mismo nombre que un recurso que ya se ha agregado a la secuencia o para el que no hay ninguna relación existente.

Requisitos

Requisito	Value
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