Classe IVssBackupComponents (vsbackup.h)

L'interfaccia IVssBackupComponents viene usata da un richiedente per eseguire il polling dello stato del file e per eseguire operazioni di backup/ripristino.

Le applicazioni ottengono un'istanza dell'interfaccia IVssBackupComponents chiamando CreateVssBackupComponents.

Un oggetto IVssBackupComponents può essere usato solo per un singolo backup, ripristino o operazione di query .

Al termine del backup, del ripristino o dell'operazione di query , un richiedente deve rilasciare l'oggetto IVssBackupComponents chiamando IVssBackupComponents::Release. Non è necessario riutilizzare un oggetto IVssBackupComponents . Ad esempio, non è possibile eseguire un'operazione di backup o ripristino con lo stesso oggetto IVssBackupComponents già usato per un'operazione di query .

Ereditarietà

L'interfaccia IVssBackupComponents eredita dall'interfaccia IUnknown . IVssBackupComponents include anche questi tipi di membri:

Metodi

La classe IVssBackupComponents include questi metodi.

IVssBackupComponents::AbortBackup Il metodo AbortBackup notifica a VSS che un'operazione di backup è stata terminata.
IVssBackupComponents::AddAlternativeLocationMapping Il metodo AddAlternativeLocationMapping viene usato da un richiedente per indicare che è stato usato un mapping di percorso alternativo per ripristinare tutti i membri di un set di file in un determinato componente.
IVssBackupComponents::AddComponent Usato per aggiungere in modo esplicito al set di backup.
IVssBackupComponents::AddNewTarget Il metodo AddNewTarget viene usato da un richiedente durante un'operazione di ripristino per indicare che l'applicazione di backup prevede di ripristinare i file in un nuovo percorso.
IVssBackupComponents::AddRestoreSubcomponent Indica che un membro subcomponente di un set di componenti, contrassegnato come non selezionabile per il backup, ma contrassegnato come selezionabile per il ripristino, deve essere ripristinato.
IVssBackupComponents::AddToSnapshotSet Il metodo AddToSnapshotSet aggiunge un volume originale o una condivisione file remota originale al set di copia shadow.
IVssBackupComponents::BackupComplete Il metodo BackupComplete causa la generazione di un evento BackupComplete, che segnala ai writer che il processo di backup è stato completato.
IVssBackupComponents::BreakSnapshotSet Il metodo BreakSnapshotSet causa l'esistenza di un set di copia shadow da "dimenticare" da VSS.
IVssBackupComponents::D eleteSnapshots Il metodo DeleteSnapshots elimina una o più copie shadow o un set di copia shadow.
IVssBackupComponents::D isableWriterClasses Il metodo DisableWriterClasses impedisce a una classe specifica di writer di ricevere eventuali eventi.
IVssBackupComponents::D isableWriterInstances Il metodo DisableWriterInstances disabilita un'istanza o un'istanza di writer specificata.
IVssBackupComponents::D oSnapshotSet Esegue il commit di tutte le copie shadow in questo set contemporaneamente.
IVssBackupComponents::EnableWriterClasses Il metodo EnableWriterClasses consente ai writer specificati di ricevere tutti gli eventi.
IVssBackupComponents::ExposeSnapshot Il metodo ExposeSnapshot espone una copia shadow come lettera di unità, cartella montata o condivisione file.
IVssBackupComponents::FreeWriterMetadata Il metodo FreeWriterMetadata libera le risorse di sistema allocate quando è stato chiamato IVssBackupComponents::GatherWriterMetadata.
IVssBackupComponents::FreeWriterStatus Il metodo FreeWriterStatus libera le risorse di sistema allocate durante la chiamata a IVssBackupComponents::GatherWriterStatus.
IVssBackupComponents::GatherWriterMetadata Il metodo GatherWriterMetadata richiede a ogni writer di inviare i metadati raccolti. Il metodo genererà un eventoIdentifi per comunicare con writer.
IVssBackupComponents::GatherWriterStatus Il metodo GatherWriterStatus richiede a ogni writer di inviare un messaggio di stato.
IVssBackupComponents::GetSnapshotProperties Il metodo GetSnapshotProperties ottiene le proprietà della copia shadow specificata.
IVssBackupComponents::GetWriterComponents Il metodo GetWriterComponents viene usato per restituire informazioni sui componenti di un determinato writer archiviato nel documento Componenti di backup di un richiedente.
IVssBackupComponents::GetWriterComponentsCount Il metodo GetWriterComponentsCount restituisce il numero di writer i cui componenti sono stati aggiunti al documento Componenti di backup del richiedente.
IVssBackupComponents::GetWriterMetadata Il metodo GetWriterMetadata restituisce i metadati per un writer specifico in esecuzione nel sistema.
IVssBackupComponents::GetWriterMetadataCount Il metodo GetWriterMetadataCount restituisce il numero di writer con metadati.
IVssBackupComponents::GetWriterStatus Il metodo GetWriterStatus restituisce lo stato del writer specificato.
IVssBackupComponents::GetWriterStatusCount Il metodo GetWriterStatusCount restituisce il numero di writer con stato.
IVssBackupComponents::ImportSnapshots Importa copie shadow trasportate da un computer diverso.
IVssBackupComponents::InitializeForBackup Il metodo InitializeForBackup inizializza i metadati dei componenti di backup in preparazione del backup.
IVssBackupComponents::InitializeForRestore Il metodo InitializeForRestore inizializza l'interfaccia IVssBackupComponents in preparazione di un'operazione di ripristino.
IVssBackupComponents::IsVolumeSupported Il metodo IsVolumeSupported determina se il provider specificato supporta copie shadow nel volume o nella condivisione file remota specificata.
IVssBackupComponents::P ostRestore Il metodo PostRestore causerà la generazione di un evento PostRestore, segnalando che l'operazione di ripristino corrente è stata completata.
IVssBackupComponents::P repareForBackup Il metodo PrepareForBackup causerà la generazione di un evento PrepareForBackup, segnalando i writer per preparare un'operazione di backup imminente. In questo modo, il documento componenti di backup di un richiedente è disponibile per i writer.
IVssBackupComponents::P reStore Il metodo PreRestore causerà la generazione di un evento PreRestore, segnalando i writer per preparare un'operazione di ripristino imminente.
IVssBackupComponents::Query Il metodo Query esegue query sui provider nel sistema e/o sulle copie shadow completate nel sistema che risiedono nel contesto corrente. Il metodo può essere chiamato solo durante le operazioni di backup.
IVssBackupComponents::QueryRevertStatus Restituisce un puntatore dell'interfaccia IVssAsync che può essere usato per determinare lo stato dell'operazione di ripristino. (IVssBackupComponents.QueryRevertStatus)
IVssBackupComponents::RevertToSnapshot Ripristina un volume in una copia shadow precedente. (IVssBackupComponents.RevertToSnapshot)
IVssBackupComponents::SaveAsXML Il metodo SaveAsXML salva il documento Componenti di backup contenente le informazioni sullo stato di un richiedente in una stringa specificata. Questo documento XML che contiene il documento Componenti di backup deve essere sempre salvato in modo sicuro come parte di un'operazione di backup.
IVssBackupComponents::SetAdditionalRestores Il metodo SetAdditionalRestores viene usato da un richiedente durante operazioni di ripristino incrementale o differenziale per indicare ai writer che un determinato componente richiederà operazioni di ripristino aggiuntive per recuperarlo completamente.
IVssBackupComponents::SetBackupOptions Il metodo SetBackupOptions imposta una stringa di parametri privati o dipendenti dal writer per un componente.
IVssBackupComponents::SetBackupState Il metodo SetBackupState definisce una configurazione complessiva per un'operazione di backup.
IVssBackupComponents::SetBackupSucceeded Il metodo SetBackupSucceeded indica se il backup del componente specificato di un writer specifico ha avuto esito positivo.
IVssBackupComponents::SetContext Il metodo SetContext imposta il contesto per le operazioni successive correlate alla copia shadow.
IVssBackupComponents::SetFileRestoreStatus Il metodo SetFileRestoreStatus indica se alcuni, tutti o nessun file sono stati ripristinati correttamente.
IVssBackupComponents::SetPreviousBackupStamp Il metodo SetPreviousBackupStamp imposta il timbro di backup di un'operazione di backup precedente, in base al quale verrà basata un'operazione di backup differenziale o incrementale.
IVssBackupComponents::SetRangesFilePath Il metodo SetRangesFilePath viene usato quando un'operazione di file parziale richiede un file di intervalli e tale file è stato ripristinato in un percorso diverso da quello originale.
IVssBackupComponents::SetRestoreOptions Il metodo SetRestoreOptions imposta una stringa di parametri privati o dipendenti dal writer per un componente writer.
IVssBackupComponents::SetRestoreState Il metodo SetRestoreState definisce una configurazione complessiva per un'operazione di ripristino.
IVssBackupComponents::SetSelectedForRestore Il metodo SetSelectedForRestore indica se il componente selezionabile specificato è selezionato per il ripristino.
IVssBackupComponents::StartSnapshotSet Il metodo StartSnapshotSet crea un nuovo set di copia shadow vuoto.

Requisiti

Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)