Método IVssBackupComponentsEx3::AddSnapshotToRecoverySet (vsbackup.h)

Artigo
03/13/2024

Especifica os volumes a serem incluídos em uma operação de ressincronização do LUN. Esse método tem suporte apenas em sistemas operacionais windows server.

Sintaxe

HRESULT AddSnapshotToRecoverySet(
  [in]           VSS_ID   snapshotId,
  [in]           DWORD    dwFlags,
  [in, optional] VSS_PWSZ pwszDestinationVolume
);

Parâmetros

[in] snapshotId

O identificador da cópia de sombra que foi retornada pelo método IVssBackupComponents::AddToSnapshotSet durante o backup. Esse parâmetro é necessário e não pode ser GUID_NULL.

[in] dwFlags

Esse parâmetro é reservado e precisa ser zero.

[in, optional] pwszDestinationVolume

Esse parâmetro é opcional e pode ser NULL. Um valor nulo significa que o conteúdo do volume de cópia de sombra deve ser copiado de volta para o volume original. O VSS identifica o volume original pelas informações de VDS_LUN_INFO no Documento de Componentes de Backup.

Retornar valor

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

Valor	Significado
S_OK 0x00000000L	A operação foi bem-sucedida.
VSS_E_BAD_STATE 0x80042301L	Não há nenhum provedor de hardware que dê suporte à operação ou o solicitante não adicionou com êxito nenhum volume ao conjunto de recuperação.
VSS_E_LEGACY_PROVIDER 0x800423F7L	Esta versão do provedor de hardware não dá suporte a essa operação.
VSS_E_OBJECT_NOT_FOUND 0x80042308L	O parâmetro snapshotId especifica uma cópia de sombra que o provedor de hardware não possui.
VSS_E_RESYNC_IN_PROGRESS 0x800423FFL	Outra operação de ressincronização do LUN já está em andamento.
VSS_E_SNAPSHOT_NOT_IN_SET 0x8004232BL	O parâmetro snapshotId especifica uma cópia de sombra que não existe no Documento de Componentes de Backup.
VSS_E_VOLUME_NOT_SUPPORTED 0x8004230CL	Não há suporte para a ressincronização de LUN nesse volume, porque é um volume dinâmico, porque o disco de destino não tem um identificador de armazenamento de página 83 exclusivo, porque o volume especificado não reside em um LUN gerenciado por um provedor de hardware VSS ou porque o disco de destino é um disco de quorum de cluster.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	vsbackup.h (inclua VsBackup.h, Vss.h, VsWriter.h)

Confira também

IVssBackupComponentsEx3

Compartilhar via