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 reversão.

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 reversão. Quando a operação for concluída, o chamador deverá liberar o ponteiro da interface chamando o método IUnknown::Release .

Valor de retorno

Esse método pode retornar um desses valores.

Value Meaning
S_OK
A operação foi bem-sucedida.
E_ACCESSDENIED
O processo de chamada tem privilégios insuficientes.
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 reversão.
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.

Observações

A operação de reversão continuará mesmo se o computador for reinicializado e não puder 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 reversão não pode ser cancelada depois de iniciada.

Requirements

Requirement Value
Cliente mínimo suportado Windows Vista com SP1 [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2008, Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header vsbackup.h (inclua VsBackup.h, Vss.h, VsWriter.h)
Library VssApi.lib

Consulte também

IVssAsync

IVssBackupComponents

IVssBackupComponents::RevertToSnapshot