Compartilhar via

Método IVssDifferentialSoftwareSnapshotMgmt3::GetVolumeProtectLevel (vsmgmt.h)

  • Artigo

Obtém o nível de proteção de cópia de sombra e status para o volume especificado.

Sintaxe

HRESULT GetVolumeProtectLevel(
  [in]  VSS_PWSZ                   pwszVolumeName,
  [out] VSS_VOLUME_PROTECTION_INFO *protectionLevel
);

Parâmetros

[in] pwszVolumeName

O nome do volume. Esse parâmetro é necessário e não pode ser NULL.

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 no formulário \\?\Volume{GUID}\ (em que o GUID identifica o volume)

[out] protectionLevel

O endereço de um buffer alocado pelo chamador que recebe uma estrutura VSS_VOLUME_PROTECTION_INFO que contém informações sobre o nível de proteção de cópia de sombra do volume.

Retornar valor

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

Valor Significado
S_OK
 O nível de proteção de cópia de sombra foi consultado com êxito.
E_ACCESSDENIED
0x80070005L
 O chamador não é um administrador.
E_INVALIDARG
0x80070057L
 Um dos valores de parâmetro não é válido.
E_NOTIMPL
0x80000001L
 O provedor para o volume não dá suporte à proteção de cópia de sombra.
VSS_E_PROVIDER_VETO
0x80042306L
 Ocorreu um erro esperado do provedor. O código de erro é registrado no log de eventos. Para obter mais informações, consulte Tratamento de eventos e erros em VSS.
VSS_E_OBJECT_NOT_FOUND
0x80042308L
 O volume especificado não foi encontrado.

Comentários

O método GetVolumeProtectLevel obtém informações sobre o nível de proteção atual do volume. Se o volume estiver em um estado com falha, o membro m_protectionFault da estrutura VSS_VOLUME_PROTECTION_INFO conterá a falha de proteção atual e o membro m_failureStatus conterá o motivo pelo qual o volume está em um estado com falha. Se o volume não estiver em um estado com falha, os membros m_protectionFault e m_failureStatus serão zero.

Se o valor do parâmetro protectionLevel for VSS_PROTECTION_LEVEL_SNAPSHOT, os solicitantes deverão definir associações de área de armazenamento de cópia de sombra (área diff) usando o método IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea .

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vsmgmt.h

Confira também

IVssDifferentialSoftwareSnapshotMgmt3

IVssDifferentialSoftwareSnapshotMgmt3::SetVolumeProtectLevel