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) |