Compartilhar via

Função ShouldBlockRevert (vsbackup.h)

  • Artigo

Verifica o registro de gravadores que devem bloquear reverter operações no volume especificado.

Nota Essa função só está disponível em sistemas operacionais Windows Server.

 

Sintaxe

HRESULT ShouldBlockRevert(
  [in]  LPCWSTR wszVolumeName,
  [out] bool    *pbBlock
);

Parâmetros

[in] wszVolumeName

O nome do volume. Esse 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] pbBlock

Um ponteiro para uma variável que recebe true se o volume contiver componentes de todos os gravadores listados no registro como gravadores que devem bloquear operações de reverter ou false caso contrário.

Valor retornado

Essa função pode retornar um desses valores.

Valor Significado
S_OK
 A função foi bem-sucedida.
E_ACCESSDENIED
 O chamador 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_UNEXPECTED
 Erro inesperado. O código de erro é registrado no arquivo de log de erros. Para obter mais informações, consulte Tratamento de eventos e erros em VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Esse valor não tem suporte até o Windows Server 2008 R2 e o Windows 7. E_UNEXPECTED é usado.

Comentários

A lista de gravadores que devem bloquear reverter operações é armazenada no registro sob a seguinte chave:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\VSS\Settings\WritersBlockingRevert

Requisitos

   
Cliente mínimo com suporte Nenhum compatível
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
DLL VssApi.dll