Compartilhar via

Método IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea (vsmgmt.h)

  • Artigo

O método AddDiffArea adiciona uma associação de área de armazenamento de cópia de sombra para o volume especificado. Se não houver suporte para a associação, um código de erro será retornado.

Sintaxe

HRESULT AddDiffArea(
  [in] VSS_PWSZ pwszVolumeName,
  [in] VSS_PWSZ pwszDiffAreaVolumeName,
  [in] LONGLONG llMaximumDiffSpace
);

Parâmetros

[in] pwszVolumeName

O nome do volume que será a origem das cópias de sombra. Esse volume está associado a uma área de armazenamento de cópia de sombra no volume pwszDiffAreaVolumeName .

O nome do volume 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)

[in] pwszDiffAreaVolumeName

O nome do volume que conterá a área de armazenamento de cópia de sombra a ser associada ao volume pwszVolumeName .

O nome do volume deve estar em um dos seguintes formatos e deve incluir uma barra invertida à direita (\):

  • O caminho de uma pasta montada
  • Uma letra de unidade, por exemplo, D:\
  • Um caminho GUID de volume do formulário \\?\Volume{GUID}\ (em que o GUID identifica o volume)

[in] llMaximumDiffSpace

O tamanho máximo, em bytes, da área de armazenamento de cópia de sombra no volume. Esse valor deve ser de pelo menos 320 MB, até o limite de todo o sistema. Se esse valor for –1, o tamanho máximo será ilimitado.

Windows Server 2003: Antes do Windows Server 2003 com SP1, o tamanho da área de armazenamento de cópia de sombra era fixo em 100 MB.

Retornar valor

Esse método pode retornar um desses valores.

Valor Significado
S_OK
 Foi adicionada com êxito a associação de área de armazenamento de cópia de sombra.
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.
E_OUTOFMEMORY
 O chamador está sem memória ou outros recursos do sistema.
VSS_E_MAXIMUM_DIFFAREA_ASSOCIATIONS_REACHED
 O número máximo de áreas de armazenamento de cópia de sombra foi adicionado ao volume de origem da cópia de sombra. O volume de armazenamento de cópia de sombra especificado não foi associado ao volume de origem de cópia de sombra especificado.
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.
VSS_E_OBJECT_ALREADY_EXISTS
 A associação entre os volumes pwszVolumeName e pwszDiffAreaVolumeName já existe.
VSS_E_PROVIDER_VETO
 Erro esperado do provedor. O provedor registrou o erro no log de eventos. Para obter mais informações, consulte Tratamento de eventos e erros em 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 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.
VSS_E_VOLUME_NOT_SUPPORTED
 O volume pwszDiffAreaVolumeName não é um volume NTFS ou não tem espaço livre insuficiente.

Comentários

Uma associação de área de armazenamento de cópia de sombra não poderá ser criada se alguma cópia de sombra já existir para o volume pwszVolumeName ou se já houver uma associação de área de armazenamento de cópia de sombra para esse volume.

A área de armazenamento de cópia de sombra para um volume de origem de disco rígido virtual (VHD) deve residir no mesmo volume. Da mesma forma, uma área de armazenamento de cópia de sombra só poderá ser criada em um volume VHD se o volume de origem for o mesmo para ambos os volumes.

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

Para alterar o tamanho de uma área de armazenamento de cópia de sombra, use o método IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize ou IVssDifferentialSoftwareSnapshotMgmt2::ChangeDiffAreaMaximumSizeEx . Você pode excluir uma área de armazenamento de cópia de sombra alterando seu tamanho para zero.

Requisitos

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

Confira também

IVssDifferentialSoftwareSnapshotMgmt