Compartilhar via


Método IXpsOMPageReference::D iscardPage (xpsobjectmodel.h)

Descarta a página da memória.

Sintaxe

HRESULT DiscardPage();

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK; caso contrário, ele retornará um código de erro HRESULT .

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
E_UNEXPECTED

DiscardPage foi chamado mais de uma vez ou a página não foi carregada.

Comentários

Se SetPage não tiver sido chamado, chamar DiscardPage e GetPage retornará a página virtualizada do pacote de origem. Se SetPage tiver sido chamado, chamar DiscardPage e GetPage retornará NULL.

Se a página referenciada por essa interface IXpsOMPageReference tiver sido construída inteiramente na memória e não tiver um arquivo correspondente, DiscardPage excluirá a página da memória e o conteúdo da página será perdido. Se a página tiver sido construída a partir de um arquivo, DiscardPage excluirá a página da memória, mas não alterará o arquivo original. A página pode ser reconstruída e lida novamente na memória chamando GetPage.

Se a página tiver sido construída a partir de um arquivo e posteriormente modificada, DiscardPage descartará a página da memória e todas as alterações feitas na página serão perdidas. Chamar GetPage depois disso lerá novamente o conteúdo original do arquivo.

Requisitos

   
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 Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho xpsobjectmodel.h

Confira também

IXpsOMPageReference

IXpsOMPageReference::GetPage

IXpsOMPageReference::SetPage

Especificação de Papel XML