Compartilhar via


Método IVssBackupComponents::QueryRevertStatus (vsbackup.h)

O método QueryRevertStatus retorna um ponteiro de interface IVssAsync que pode ser usado para determinar o status da operação de reverter.

Sintaxe

HRESULT QueryRevertStatus(
  [in]  VSS_PWSZ  pwszVolume,
  [out] IVssAsync **ppAsync
);

Parâmetros

[in] pwszVolume

Cadeia de caracteres largos terminada em nulo que contém o nome do volume. O nome deve estar em um dos seguintes formatos e deve incluir uma barra invertida à direita (\):

  • O caminho de uma pasta montada, por exemplo, Y:\MountX\
  • Uma letra de unidade, por exemplo, D:\
  • Um caminho GUID de volume do formulário \\?\Volume{GUID}\ (em que o GUID identifica o volume)

[out] ppAsync

Ponteiro para um local que receberá um ponteiro de interface IVssAsync que pode ser usado para recuperar o status do processo de reverter. Quando a operação for concluída, o chamador deverá liberar o ponteiro da interface chamando o método IUnknown::Release .

Retornar valor

Esse método pode retornar um desses valores.

Valor Significado
S_OK
A operação foi bem-sucedida.
E_ACCESSDENIED
O processo de chamada não tem privilégios suficientes.
E_FAIL
Há um erro interno.
E_INVALIDARG
Um dos parâmetros passados não é válido.
E_NOTIMPL
O provedor para o volume não dá suporte a operações de reverter.
E_OUTOFMEMORY
O chamador está sem memória ou outros recursos do sistema.
E_POINTER
Um dos parâmetros de ponteiro necessários é NULL.
VSS_E_OBJECT_NOT_FOUND
O parâmetro pwszVolume não é um volume válido.
VSS_E_VOLUME_NOT_SUPPORTED
Não há suporte para Reverter nesse volume.

Comentários

A operação de reverter continuará mesmo se o computador for reinicializado e não poderá ser cancelado ou desfeito, exceto restaurando um backup criado usando outro método. O método QueryStatus no retornado
A interface IVssAsync não pode retornar VSS_S_ASYNC_CANCELLED, pois a operação de reverter não pode ser cancelada após o início.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista com SP1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008, Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vsbackup.h (inclua VsBackup.h, Vss.h, VsWriter.h)
Biblioteca VssApi.lib

Confira também

IVssAsync

IVssBackupComponents

IVssBackupComponents::RevertToSnapshot