Metodo IXpsOMPackageWriter::AddResource (xpsobjectmodel.h)

Articolo
08/28/2023

Crea una nuova risorsa di parte nel pacchetto.

Sintassi

HRESULT AddResource(
  [in] IXpsOMResource *resource
);

Parametri

[in] resource

Interfaccia IXpsOMResource della risorsa della parte che verrà aggiunta come nuova parte nel pacchetto. Vedere Osservazioni per i tipi di risorse che possono essere passati in questo parametro.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a quelli della tabella che segue. Per informazioni sui valori restituiti dall'API documento XPS non elencati in questa tabella, vedere Errori del documento XPS.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_INVALIDARG	Una risorsa con lo stesso nome della risorsa a cui fa riferimento la risorsa è già stata aggiunta al flusso o non esiste alcuna relazione che include la risorsa a cui fa riferimento la risorsa. Dopo aver restituito E_INVALIDARG, il flusso o il file non è più valido e Close restituirà XPS_E_UNAVAILABLE_PACKAGE.
XPS_E_UNAVAILABLE_PACKAGE	Si è verificato un errore grave e il contenuto di XPS OM potrebbe non essere recuperabile. Alcuni componenti dell'OM XPS potrebbero comunque essere utilizzabili, ma solo dopo che sono stati verificati. Poiché lo stato di XPS OM non può essere stimato dopo la restituzione di questo errore, tutti i componenti dell'OM XPS devono essere rilasciati ed eliminati.

Questo metodo chiama l'API Creazione pacchetti . Per informazioni sui valori restituiti dall'API packaging, vedere Errori di creazione di pacchetti.

Commenti

Questo metodo crea una nuova parte nel pacchetto del documento che corrisponde alla risorsa, aggiunge il contenuto della risorsa alla nuova parte e quindi chiude la nuova parte.

Se questo metodo restituisce un errore, il writer del pacchetto non è più utilizzabile.

Il parametro della risorsa deve essere uno dei seguenti:

Interfaccia IXpsOMFontResource di una risorsa di tipo carattere usata nella pagina corrente o in una pagina già aggiunta.
Interfaccia IXpsOMImageResource di una risorsa immagine usata nella pagina corrente o in una pagina già aggiunta.
Interfaccia IXpsOMColorProfileResource della risorsa profilo colore usata nella pagina corrente o in una pagina già aggiunta.
Interfaccia IXpsOMStoryFragmentsResource di una risorsa di frammenti di storia usata nella pagina corrente o in una pagina già aggiunta.
Interfaccia IXpsOMDocumentStructureResource di una risorsa struttura documento usata nel documento corrente o in un documento già aggiunto.
Interfaccia IXpsOMSignatureBlockResource di una risorsa del blocco di firma usata nel documento corrente o in un documento già aggiunto.

Questo metodo restituisce un errore se la risorsa contiene uno dei seguenti elementi:

Interfaccia IXpsOMRemoteDictionaryResource di un dizionario risorse remoto.
Interfaccia IXpsOMPrintTicketResource di un ticket di stampa.
Interfaccia IXpsOMImageResource di un'immagine di anteprima.

Questo metodo restituisce un errore quando la risorsa fa riferimento a una risorsa con lo stesso nome di una risorsa già aggiunta al flusso o per cui non esiste alcuna relazione esistente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	xpsobjectmodel.h