Método IXpsOMPackageWriter::AddResource (xpsobjectmodel.h)
Cria um novo recurso de parte no pacote.
Sintaxe
HRESULT AddResource(
[in] IXpsOMResource *resource
);
Parâmetros
[in] resource
A interface IXpsOMResource do recurso de parte que será adicionada como uma nova parte no pacote. Consulte Comentários para obter os tipos de recursos que podem ser passados nesse parâmetro.
Retornar valor
O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir. Para obter informações sobre valores retornados da API de documento XPS que não estão listados nesta tabela, consulte Erros de documento XPS.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
Um recurso com o mesmo nome do recurso referenciado pelo recurso já foi adicionado ao fluxo ou não há nenhuma relação que inclua o recurso referenciado pelo recurso.
Depois que E_INVALIDARG é retornado, o fluxo ou arquivo não é mais válido e Close retornará XPS_E_UNAVAILABLE_PACKAGE. |
|
Ocorreu um erro grave e o conteúdo do OM XPS pode ser irrecuperável. Alguns componentes do OM XPS ainda podem ser utilizáveis, mas somente depois de terem sido verificados. Como o estado do OM XPS não pode ser previsto após esse erro ser retornado, todos os componentes do OM XPS devem ser liberados e descartados. |
Esse método chama a API de Empacotamento . Para obter informações sobre os valores retornados da API de Empacotamento, consulte Erros de empacotamento.
Comentários
Esse método cria uma nova parte no pacote de documentos que corresponde ao recurso, adiciona o conteúdo do recurso à nova parte e fecha a nova parte.
Se esse método retornar um erro, o gravador de pacote não será mais utilizável.
O parâmetro de recurso deve ser um dos seguintes:
- A interface IXpsOMFontResource de um recurso de fonte que é usado na página atual ou em uma página que já foi adicionada.
- A interface IXpsOMImageResource de um recurso de imagem que é usado na página atual ou em uma página que já foi adicionada.
- A interface IXpsOMColorProfileResource do recurso de perfil de cor que é usado na página atual ou em uma página que já foi adicionada.
- A interface IXpsOMStoryFragmentsResource de um recurso de fragmentos de história que é usado na página atual ou em uma página que já foi adicionada.
- A interface IXpsOMDocumentStructureResource de um recurso de estrutura de documento que é usado no documento atual ou em um documento que já foi adicionado.
- A interface IXpsOMSignatureBlockResource de um recurso de bloco de assinatura usado no documento atual ou em um documento que já foi adicionado.
Esse método retornará um erro se o recurso contiver um dos seguintes:
- A interface IXpsOMRemoteDictionaryResource de um dicionário de recursos remotos.
- A interface IXpsOMPrintTicketResource de um tíquete de impressão.
- A interface IXpsOMImageResource de uma imagem em miniatura.
Esse método retorna um erro quando o recurso faz referência a um recurso que tem o mesmo nome de um recurso que já foi adicionado ao fluxo ou para o qual não há nenhuma relação existente.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | xpsobjectmodel.h |