Método IVssBackupComponents::D oSnapshotSet (vsbackup.h)
Confirma todas as cópias de sombra nesse conjunto simultaneamente.
Sintaxe
HRESULT DoSnapshotSet(
[out] IVssAsync **ppAsync
);
Parâmetros
[out] ppAsync
Um ponteiro duplamente indireto para a interface assíncrona IVssAsync necessária. Isso é usado para consultar o estado de execução do método e para recuperar o código de erro final.
Retornar valor
Veja a seguir os códigos de retorno válidos para esse método. Esses códigos de erro podem ser retornados desse método ou do método QueryStatus na interface IVssAsync retornada no parâmetro ppAsync .
| Valor | Significado |
|---|---|
|
Retornou com êxito um ponteiro para uma instância da interface IVssAsync . Consulte IVssAsync::QueryStatus para obter os valores válidos retornados pelo parâmetro pHrResult . |
|
O chamador não tem privilégios de backup suficientes ou não é um administrador. |
|
ppAsync não aponta para um ponteiro válido; ou seja, é NULL. |
|
O chamador está sem memória ou outros recursos do sistema. |
|
O objeto de componentes de backup não foi inicializado ou as chamadas de pré-requisito para um determinado contexto de cópia de sombra não foram feitas antes de chamar DoSnapshotSet. |
|
O sistema ou provedor não tem espaço de armazenamento suficiente. Se possível, exclua cópias de sombra persistentes antigas ou desnecessárias e tente novamente. Esse código de erro só é retornado por meio do método QueryStatus na interface IVssAsync retornada no parâmetro ppAsync . |
|
O sistema não pôde liberar gravações de E/S. Isso pode ser um problema transitório. É recomendável aguardar dez minutos e tentar novamente, até três vezes. |
|
O sistema não pôde manter gravações de E/S. Isso pode ser um problema transitório. É recomendável aguardar dez minutos e tentar novamente, até três vezes. |
|
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. |
|
O provedor não pôde executar a solicitação no momento. Isso pode ser um problema transitório. É recomendável aguardar dez minutos e tentar novamente, até três vezes. Esse código de erro só é retornado por meio do método QueryStatus na interface IVssAsync retornada no parâmetro ppAsync . |
|
O provedor encontrou um erro que exige que o usuário reinicie o computador.
Windows Server 2003 e Windows XP: Não há suporte para esse valor. |
|
O sistema não pôde congelar o DTC (Coordenador de Transações Distribuídas) ou o KTM (Kernel Transaction Manager).
Windows Server 2003 e Windows XP: Não há suporte para esse valor. |
|
O sistema não pôde descongelar o DTC (Coordenador de Transações Distribuídas) ou o KTM (Kernel Transaction Manager).
Windows Server 2003 e Windows XP: Não há suporte para esse valor. |
|
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. |
|
O provedor retornou um código de erro inesperado. Isso pode ser um problema transitório. É recomendável aguardar dez minutos e tentar novamente, até três vezes. Esse código de erro só é retornado por meio do método QueryStatus na interface IVssAsync retornada no parâmetro ppAsync . |
Comentários
O chamador é responsável por liberar a interface IVssAsync .
Esse método não pode ser chamado para um VHD (disco rígido virtual) aninhado dentro de outro VHD.
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para VHDs.
Para obter informações sobre como usar IVssBackupComponents::D oSnapshotSet para criar uma cópia de sombra de backup padrão, consulte Visão geral de tarefas de pré-backup e criação de cópia de sombra simples para backup. Para obter informações sobre como o método é usado em diferentes contextos do VSS, consulte Detalhes de implementação para criar cópias de sombra.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [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
IVssBackupComponents::AddComponent
IVssBackupComponents::AddToSnapshotSet