Método IVssBackupComponents::D oSnapshotSet (vsbackup.h)

Artigo
03/03/2024

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
S_OK	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 .
E_ACCESSDENIED	O chamador não tem privilégios de backup suficientes ou não é um administrador.
E_INVALIDARG	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 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.
VSS_E_INSUFFICIENT_STORAGE	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 .
VSS_E_FLUSH_WRITES_TIMEOUT	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.
VSS_E_HOLD_WRITES_TIMEOUT	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.
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_PROVIDER_VETO	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 .
VSS_E_REBOOT_REQUIRED	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.
VSS_E_TRANSACTION_FREEZE_TIMEOUT	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.
VSS_E_TRANSACTION_THAW_TIMEOUT	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.
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.
VSS_E_UNEXPECTED_PROVIDER_ERROR	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