Compartilhar via

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

  • Artigo

Define o nível de proteção de cópia de sombra para um volume original ou um volume de área de armazenamento de cópia de sombra.

Sintaxe

HRESULT SetVolumeProtectLevel(
  [in] VSS_PWSZ             pwszVolumeName,
  [in] VSS_PROTECTION_LEVEL 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)

[in] protectionLevel

Um valor da enumeração VSS_PROTECTION_LEVEL que especifica o nível de proteção de cópia de sombra.

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 definido 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 SetVolumeProtectLevel verifica o nível de proteção de cópia de sombra atual do volume. Se o volume estiver em um estado com falha e VSS_PROTECTION_LEVEL_ORIGINAL_VOLUME for especificado para o parâmetro protectionLevel , SetVolumeProtectLevel desmonta o volume antes de definir o nível de proteção.

Se o nível de proteção atual do volume for o mesmo que o valor do parâmetro protectionLevel , SetVolumeProtectLevel não fará nada.

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::GetVolumeProtectLevel