Classe IVssBackupComponents (vsbackup.h)

A interface IVssBackupComponents é usada por um solicitante para sondar gravadores sobre status de arquivo e executar operações de backup/restauração.

Os aplicativos obtêm uma instância da interface IVssBackupComponents chamando CreateVssBackupComponents.

Um objeto IVssBackupComponents pode ser usado apenas para uma única operação de backup, restauração ou consulta .

Depois que a operação de backup, restauração ou consulta tiver sido concluída ou encerrada explicitamente, um solicitante deverá liberar o objeto IVssBackupComponents chamando IVssBackupComponents::Release. Um objeto IVssBackupComponents não deve ser reutilizado. Por exemplo, você não pode executar uma operação de backup ou restauração com o mesmo objeto IVssBackupComponents que você já usou para uma operação de consulta.

Herança

A interface IVssBackupComponents herda da interface IUnknown . IVssBackupComponents também tem esses tipos de membros:

Métodos

A classe IVssBackupComponents tem esses métodos.

IVssBackupComponents::AbortBackup O método AbortBackup notifica o VSS de que uma operação de backup foi encerrada.
IVssBackupComponents::AddAlternativeLocationMapping O método AddAlternativeLocationMapping é usado por um solicitante para indicar que um mapeamento de local alternativo foi usado para restaurar todos os membros de um conjunto de arquivos em um determinado componente.
IVssBackupComponents::AddComponent Usado para adicionar explicitamente ao conjunto de backup.
IVssBackupComponents::AddNewTarget O método AddNewTarget é usado por um solicitante durante uma operação de restauração para indicar que o aplicativo de backup planeja restaurar arquivos para um novo local.
IVssBackupComponents::AddRestoreSubcomponent Indica que um membro subcomponente de um conjunto de componentes, que tinha sido marcado como não selecionável para backup, mas está marcado como selecionável para restauração, deve ser restaurado.
IVssBackupComponents::AddToSnapshotSet O método AddToSnapshotSet adiciona um volume original ou compartilhamento de arquivo remoto original ao conjunto de cópias de sombra.
IVssBackupComponents::BackupComplete O método BackupComplete faz com que o VSS gere um evento BackupComplete, que sinaliza aos gravadores que o processo de backup foi concluído.
IVssBackupComponents::BreakSnapshotSet O método BreakSnapshotSet faz com que a existência de um conjunto de cópias de sombra seja "esquecida" pelo VSS.
IVssBackupComponents::D eleteSnapshots O método DeleteSnapshots exclui uma ou mais cópias de sombra ou um conjunto de cópias de sombra.
IVssBackupComponents::D isableWriterClasses O método DisableWriterClasses impede que uma classe específica de gravadores receba eventos.
IVssBackupComponents::D isableWriterInstances O método DisableWriterInstances desabilita uma instância ou instância de gravador especificada.
IVssBackupComponents::D oSnapshotSet Confirma todas as cópias de sombra nesse conjunto simultaneamente.
IVssBackupComponents::EnableWriterClasses O método EnableWriterClasses permite que os gravadores especificados recebam todos os eventos.
IVssBackupComponents::ExposeSnapshot O método ExposeSnapshot expõe uma cópia de sombra como uma letra da unidade, uma pasta montada ou um compartilhamento de arquivos.
IVssBackupComponents::FreeWriterMetadata O método FreeWriterMetadata libera recursos do sistema alocados quando IVssBackupComponents::GatherWriterMetadata foi chamado.
IVssBackupComponents::FreeWriterStatus O método FreeWriterStatus libera recursos do sistema alocados durante a chamada para IVssBackupComponents::GatherWriterStatus.
IVssBackupComponents::GatherWriterMetadata O método GatherWriterMetadata solicita que cada gravador envie os metadados coletados. O método gerará um evento Identifi para se comunicar com gravadores.
IVssBackupComponents::GatherWriterStatus O método GatherWriterStatus solicita que cada gravador envie uma mensagem status.
IVssBackupComponents::GetSnapshotProperties O método GetSnapshotProperties obtém as propriedades da cópia de sombra especificada.
IVssBackupComponents::GetWriterComponents O método GetWriterComponents é usado para retornar informações sobre os componentes de um determinado gravador que foram armazenados no Documento de Componentes de Backup de um solicitante.
IVssBackupComponents::GetWriterComponentsCount O método GetWriterComponentsCount retorna o número de gravadores cujos componentes foram adicionados ao Documento de Componentes de Backup de um solicitante.
IVssBackupComponents::GetWriterMetadata O método GetWriterMetadata retorna os metadados de um gravador específico em execução no sistema.
IVssBackupComponents::GetWriterMetadataCount O método GetWriterMetadataCount retorna o número de gravadores com metadados.
IVssBackupComponents::GetWriterStatus O método GetWriterStatus retorna a status do gravador especificado.
IVssBackupComponents::GetWriterStatusCount O método GetWriterStatusCount retorna o número de gravadores com status.
IVssBackupComponents::ImportSnapshots Importa cópias de sombra transportadas de um computador diferente.
IVssBackupComponents::InitializeForBackup O método InitializeForBackup inicializa os metadados dos componentes de backup em preparação para backup.
IVssBackupComponents::InitializeForRestore O método InitializeForRestore inicializa a interface IVssBackupComponents em preparação para uma operação de restauração.
IVssBackupComponents::IsVolumeSupported O método IsVolumeSupported determina se o provedor especificado dá suporte a cópias de sombra no volume especificado ou no compartilhamento de arquivos remoto.
IVssBackupComponents::P ostRestore O método PostRestore fará com que o VSS gere um evento PostRestore, sinalizando aos gravadores que a operação de restauração atual foi concluída.
IVssBackupComponents::P repareForBackup O método PrepareForBackup fará com que o VSS gere um evento PrepareForBackup, sinalizando os gravadores para se prepararem para uma operação de backup futura. Isso disponibiliza o Documento de Componentes de Backup de um solicitante para gravadores.
IVssBackupComponents::P reRestore O método PreRestore fará com que o VSS gere um evento PreRestore, sinalizando os gravadores para se prepararem para uma operação de restauração futura.
IVssBackupComponents::Query O método Query consulta provedores no sistema e/ou as cópias de sombra concluídas no sistema que residem no contexto atual. O método só pode ser chamado durante operações de backup.
IVssBackupComponents::QueryRevertStatus Retorna um ponteiro de interface IVssAsync que pode ser usado para determinar o status da operação de reverter. (IVssBackupComponents.QueryRevertStatus)
IVssBackupComponents::RevertToSnapshot Reverte um volume para uma cópia de sombra anterior. (IVssBackupComponents.RevertToSnapshot)
IVssBackupComponents::SaveAsXML O método SaveAsXML salva o Documento de Componentes de Backup que contém informações de estado de um solicitante em uma cadeia de caracteres especificada. Este documento XML, que contém o Documento de Componentes de Backup, sempre deve ser salvo com segurança como parte de uma operação de backup.
IVssBackupComponents::SetAdditionalRestores O método SetAdditionalRestores é usado por um solicitante durante operações de restauração incremental ou diferencial para indicar aos gravadores que um determinado componente exigirá operações de restauração adicionais para recuperá-lo completamente.
IVssBackupComponents::SetBackupOptions O método SetBackupOptions define uma cadeia de caracteres de parâmetros de backup privados ou dependentes do gravador para um componente.
IVssBackupComponents::SetBackupState O método SetBackupState define uma configuração geral para uma operação de backup.
IVssBackupComponents::SetBackupSucceeded O método SetBackupSucceeded indica se o backup do componente especificado de um gravador específico foi bem-sucedido.
IVssBackupComponents::SetContext O método SetContext define o contexto para operações subsequentes relacionadas à cópia de sombra.
IVssBackupComponents::SetFileRestoreStatus O método SetFileRestoreStatus indica se alguns, todos ou nenhum arquivo foram restaurados com êxito.
IVssBackupComponents::SetPreviousBackupStamp O método SetPreviousBackupStamp define o carimbo de backup de uma operação de backup anterior, na qual uma operação de backup diferencial ou incremental será baseada.
IVssBackupComponents::SetRangesFilePath O método SetRangesFilePath é usado quando uma operação de arquivo parcial requer um arquivo de intervalos e esse arquivo foi restaurado para um local diferente do original.
IVssBackupComponents::SetRestoreOptions O método SetRestoreOptions define uma cadeia de caracteres de parâmetros de restauração privados ou dependentes do gravador para um componente gravador.
IVssBackupComponents::SetRestoreState O método SetRestoreState define uma configuração geral para uma operação de restauração.
IVssBackupComponents::SetSelectedForRestore O método SetSelectedForRestore indica se o componente selecionável especificado está selecionado para restauração.
IVssBackupComponents::StartSnapshotSet O método StartSnapshotSet cria um novo conjunto de cópias de sombra vazio.

Requisitos

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)