Compartilhar via

Método IVssDifferentialSoftwareSnapshotMgmt3::D eleteUnusedDiffAreas (vsmgmt.h)

  • Artigo

Exclui todas as áreas de armazenamento de cópia de sombra (também chamadas de áreas de comparação) no volume especificado que não estão em uso.

Sintaxe

HRESULT DeleteUnusedDiffAreas(
  [in] VSS_PWSZ pwszDiffAreaVolumeName
);

Parâmetros

[in] pwszDiffAreaVolumeName

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)

Retornar valor

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

Valor Significado
S_OK
 As áreas de armazenamento de cópia de sombra foram excluídas 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

Arquivos de área de armazenamento de cópia de sombra não utilizados são encontrados em volumes de área de armazenamento quando o volume original associado está offline devido a uma falha de proteção. Em determinados casos, o volume original pode ser permanentemente perdido e chamar o método DeleteUnusedDiffAreas é a única maneira de recuperar o espaço de área de armazenamento abandonado.

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