Método IVssBackupComponents::ImportSnapshots (vsbackup.h)

O método ImportSnapshots importa cópias de sombra transportadas de um computador diferente.

Nota Esse método tem suporte apenas em sistemas operacionais Windows Server e para provedores de hardware do Serviço de Cópia de Sombra de Volume.

 

Sintaxe

HRESULT ImportSnapshots(
  [out] IVssAsync **ppAsync
);

Parâmetros

[out] ppAsync

Ponteiro indireto duplamente para um objeto IVssAsync que contém a cópia de sombra importada status dados.

Retornar valor

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

Valor	Significado
S_OK	Retornou com êxito um ponteiro para uma instância da interface IVssAsync . Consulte a página de referência de IVssAsync::QueryStatus para obter os códigos de erro retornados no parâmetro pHrResult .
E_ACCESSDENIED	O chamador não tem privilégios de backup suficientes ou não é um administrador.
E_INVALIDARG	O parâmetro ppAsync não aponta para um ponteiro válido; ou seja, é NULL.
E_OUTOFMEMORY	O chamador está sem memória ou outros recursos do sistema.
VSS_E_BAD_STATE	O objeto de componentes de backup não é inicializado, esse método foi chamado durante uma operação de restauração ou esse método não foi chamado de dentro da sequência correta.
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 no 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.

Comentários

Somente uma cópia de sombra pode ser importada por vez.

O solicitante é responsável por serializar a operação de importação de cópia de sombra.

O chamador é responsável por liberar a interface IVssAsync .

Para obter mais informações sobre como importar cópias de sombra, consulte Importando volumes copiados de sombra transportável.

Cópias de sombra transportáveis em um cluster: Para obter detalhes sobre como usar cópias de sombra transportáveis em um cluster, consulte Recuperação rápida usando volumes copiados de sombra transportáveis. A cópia de sombra transportável deve ser importada de fora do cluster, desde que o volume original seja montado dentro do cluster.

Nota Se a importação de cópia de sombra falhar, o Serviço de Cópia de Sombra de Volume não limpo LUNs por conta própria. O solicitante precisa iniciar a limpeza de LUNs.

 

Requisitos

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

Confira também

IVssAsync

IVssAsync::QueryStatus

IVssBackupComponents

IVssBackupComponents::ExposeSnapshot

IVssBackupComponents::InitializeForBackup