Compartilhar via


Método IVssSoftwareSnapshotProvider::QueryRevertStatus (vsprov.h)

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 da operação 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

Veja a seguir os códigos de retorno válidos para esse método.

Valor Significado
S_OK
O status da operação de reverter foi consultado com êxito.
E_ACCESSDENIED
O chamador não tem privilégios de backup suficientes ou não é um administrador.
E_INVALIDARG
Um dos valores de parâmetro não é válido.
E_OUTOFMEMORY
O chamador está sem memória ou outros recursos do sistema.
VSS_E_OBJECT_NOT_FOUND
O parâmetro pwszVolume não especifica um volume válido.
VSS_E_VOLUME_NOT_SUPPORTED
Não há suporte para a operação de 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 que foi criado usando outro método. O método IVssAsync::QueryStatus 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 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vsprov.h
Biblioteca VssApi.lib

Confira também

IVssSoftwareSnapshotProvider