Compartilhar via

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

  • Artigo

Determina se o provedor dá suporte a cópias de sombra no volume especificado.

Sintaxe

HRESULT IsVolumeSupported(
  [in]  VSS_PWSZ pwszVolumeName,
  [out] BOOL     *pbSupportedByThisProvider
);

Parâmetros

[in] pwszVolumeName

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 da unidade, por exemplo, D:\
  • Um caminho GUID de volume do formulário \\?\Volume{GUID}\ (em que o GUID identifica o volume)

[out] pbSupportedByThisProvider

Esse parâmetro receberá TRUE se houver suporte para cópias de sombra no volume especificado; caso contrário, FALSE.

Valor retornado

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

Valor Significado
S_OK
 As informações solicitadas foram retornadas 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.
VSS_E_NESTED_VOLUME_LIMIT
 O volume especificado está aninhado muito profundamente para participar da operação vss.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse código de retorno.
E_OUTOFMEMORY
 O chamador está sem memória ou outros recursos do sistema.
VSS_E_OBJECT_NOT_FOUND
 O volume especificado não foi encontrado.
VSS_E_PROVIDER_VETO
 Erro do provedor. O provedor registrou o erro no log de eventos. Para obter mais informações, consulte Tratamento de eventos e erros no VSS.
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 no 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

O método IsVolumeSupported retornará TRUE se for possível criar cópias de sombra no volume especificado, mesmo que a configuração atual não permita a criação de cópias de sombra nesse volume no momento.

Por exemplo, se o número máximo de cópias de sombra tiver sido atingido em um determinado volume (e, portanto, não for possível criar mais cópias de sombra nesse volume), o método ainda indicará que o volume pode ser copiado por sombra.

Esse método não pode ser chamado para um VHD (disco rígido virtual) aninhado dentro de outro VHD.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para VHDs.

Requisitos

   
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