Condividi tramite


Classe IVssComponent (vswriter.h)

L'interfaccia IVssComponent è un'interfaccia C++ (non COM) contenente metodi per esaminare e modificare informazioni sui componenti contenuti nel documento Componenti di backup di un richiedente.

Gli oggetti IVssComponent possono essere ottenuti solo per i componenti aggiunti in modo esplicito al documento Componenti di backup durante un'operazione di backup dal metodo IVssBackupComponents::AddComponent .

Le informazioni sui componenti aggiunti in modo esplicito durante un'operazione di ripristino tramite IVssBackupComponents::AddRestoreSubcomponent non sono disponibili tramite l'interfaccia IVssComponent .

Alcune informazioni comuni sia ai componenti che ai sottocomponenti selezionati in modo implicito disponibili tramite gli oggetti IVssComponent includono quanto segue:

  • Timestamp di backup
  • Messaggi di errore pre-/post-ripristino
  • Ripristinare i metadati
  • Destinazione di ripristino
Alcune informazioni nell'oggetto IVssComponent sono basate su file e possono fare riferimento ai file gestiti da componenti selezionati in modo esplicito o da sottocomponenti selezionati in modo implicito:
  • Mapping di percorsi alternativi
  • File parziali
  • Destinazione diretta
Altre informazioni non sono incluse nel documento dei componenti di backup e possono essere dedotte usando l'oggetto IVssComponent insieme ai documenti di metadati writer appropriati in base alla gerarchia dei componenti di un writer espressa nei percorsi logici (vedere Utilizzo della selezione e dei percorsi logici).

L'interfaccia può essere usata da un writer o da un richiedente, anche se alcuni metodi sono supportati solo per i writer. In questo modo, un writer può richiedere modifiche in un'operazione di backup o ripristino, ad esempio l'aggiunta di una nuova destinazione o l'apprendimento delle azioni del richiedente, ad esempio l'uso di un percorso alternativo.

I metodi seguenti restituiscono un'interfaccia IVssComponent :

Ereditarietà

L'interfaccia IVssComponent eredita dall'interfaccia IUnknown . IVssComponent ha anche questi tipi di membri:

Metodi

La classe IVssComponent dispone di questi metodi.

 
IVssComponent::AddDifferencedFilesByLastModifyLSN

Non supportato. (IVssComponent.AddDifferencedFilesByLastModifyLSN)
IVssComponent::AddDifferencedFilesByLastModifyTime

Usato da un writer per indicare che un set di file (un file o file specificato) deve essere valutato rispetto a un timestamp dell'ultima modifica per l'inclusione in un backup incrementale o differenziale con timestamp utilizzando interi file.
IVssComponent::AddDirectedTarget

Il metodo AddDirectedTarget consente a un writer di indicare in fase di ripristino che, quando un file deve essere ripristinato, il file di origine deve essere mappato di nuovo.
IVssComponent::AddPartialFile

Il metodo AddPartialFile indica che è necessario eseguire il backup solo di parti di un determinato file e quali parti sono.
IVssComponent::GetAdditionalRestores

Il metodo GetAdditionalRestores viene usato da un writer durante operazioni di ripristino incrementale o differenziale per determinare se un determinato componente richiederà operazioni di ripristino aggiuntive per recuperarlo completamente.
IVssComponent::GetAlternateLocationMapping

GetAlternateLocationMapping viene usato per restituire il percorso alternativo di un set di file per il ripristino dei file. Questo metodo può essere chiamato da un writer o da un richiedente.
IVssComponent::GetAlternateLocationMappingCount

Il metodo GetAlternateLocationMappingCount restituisce il numero di mapping di percorsi alternativi utilizzati da un richiedente per il ripristino dei dati. Un writer o un richiedente può chiamare questo metodo.
IVssComponent::GetBackupMetadata

Il metodo GetBackupMetadata recupera i metadati di backup privati specifici del writer che potrebbero essere stati impostati durante un evento PrepareForBackup da CVssWriter::OnPrepareBackup usando IVssComponent::SetBackupMetadata.
IVssComponent::GetBackupOptions

Il metodo GetBackupOptions restituisce le opzioni di backup specificate nel writer che gestisce il componente o il componente attualmente selezionato impostato da un richiedente tramite IVssBackupComponents::SetBackupOptions.
IVssComponent::GetBackupStamp

Il metodo GetBackupStamp restituisce la stringa del timbro di backup archiviata da un writer per un determinato componente.
IVssComponent::GetBackupSucceeded

Il metodo GetBackupSucceeded restituisce lo stato di un tentativo completo di eseguire il backup di tutti i file di un componente o di un componente selezionato impostato come enumerazione VSS_FILE_RESTORE_STATUS.
IVssComponent::GetComponentName

Il metodo GetComponentName restituisce il nome logico di questo componente.
IVssComponent::GetComponentType

Il metodo GetComponentType restituisce il tipo di questo componente in termini di enumerazione VSS_COMPONENT_TYPE.
IVssComponent::GetDifferencedFile

Il metodo GetDifferencedFile restituisce informazioni su un set di file (un file o file specificato) per partecipare a un backup incrementale o differenziale o a un ripristino come file diverso, ovvero il backup e i ripristini associati a esso, come se interi file vengano copiati da e verso supporti di backup (anziché usare file parziali).
IVssComponent::GetDifferencedFilesCount

Restituisce il numero di specifiche di file in questo componente (e in qualsiasi sottocomponente del set di componenti definito) contrassegnati da un writer che supporta un backup incrementale o un ripristino come file differenze.
IVssComponent::GetDirectedTarget

Il metodo GetDirectedTarget restituisce le informazioni archiviate da un writer, in fase di backup, nel documento Componenti di backup per indicare che, quando un file deve essere ripristinato, deve essere ricreato (il file di origine).
IVssComponent::GetDirectedTargetCount

Il metodo GetDirectedTargetCount restituisce il numero di specifiche di destinazione dirette associate al componente corrente. Un writer o un richiedente può chiamare questo metodo.
IVssComponent::GetFileRestoreStatus

Il metodo GetFileRestoreStatus restituisce lo stato di un tentativo completato di ripristinare tutti i file di un componente o di un componente selezionato impostato come enumerazione VSS_FILE_RESTORE_STATUS.
IVssComponent::GetLogicalPath

Il metodo GetLogicalPath restituisce il percorso logico di questo componente.
IVssComponent::GetNewTarget

Il metodo GetNewTarget restituisce i nuovi percorsi di ripristino dei file per il componente o il set di componenti selezionato.
IVssComponent::GetNewTargetCount

Il metodo GetNewTargetCount restituisce il numero di nuovi percorsi di ripristino di destinazione associati a un determinato componente.
IVssComponent::GetPartialFile

Il metodo GetPartialFile restituisce informazioni su un file parziale associato a questo componente.
IVssComponent::GetPartialFileCount

Il metodo GetPartialFileCount restituisce il numero di file parziali associati a un componente.
IVssComponent::GetPostRestoreFailureMsg

Il metodo GetPostRestoreFailureMsg restituisce il messaggio di errore generato da un writer durante la gestione dell'evento PostRestore, se IVssComponent::SetPostRestoreFailureMsg ne imposta uno.
IVssComponent::GetPreRestoreFailureMsg

Il metodo GetPreRestoreFailureMsg recupera il messaggio di errore generato da un writer durante la gestione dell'evento PreRestore, se IVssComponent::SetPreRestoreFailureMsg ne imposta uno.
IVssComponent::GetPreviousBackupStamp

Il metodo GetPreviousBackupStamp restituisce un indicatore di backup precedente caricato da un richiedente nel documento Componenti di backup. Il valore viene usato da un writer quando si decide se i file devono partecipare all'operazione di backup differenziale o incrementale.
IVssComponent::GetRestoreMetadata

Il metodo GetRestoreMetadata recupera metadati di ripristino privati specifici del writer che potrebbero essere stati impostati durante un evento PreRestore da CVssWriter::OnPreRestore usando IVssComponent::SetRestoreMetadata.
IVssComponent::GetRestoreOptions

Il metodo GetRestoreOptions ottiene le opzioni di ripristino specificate per il writer corrente da un richiedente usando IVssBackupComponents::SetRestoreOptions.
IVssComponent::GetRestoreSubcomponent

Il metodo GetRestoreSubcomponent restituisce il sottocomponente specificato associato a un determinato componente.
IVssComponent::GetRestoreSubcomponentCount

Il metodo GetRestoreSubcomponentCount restituisce il numero di sottocomponenti associati a un componente.
IVssComponent::GetRestoreTarget

Il metodo GetRestoreTarget restituisce la destinazione di ripristino (in termini di enumerazione VSS_RESTORE_TARGET) per il componente corrente.
IVssComponent::IsSelectedForRestore

Il metodo IsSelectedForRestore determina se è stato selezionato il componente corrente da ripristinare.
IVssComponent::SetBackupMetadata

Il metodo SetBackupMetadata imposta i metadati di backup con il componente .
IVssComponent::SetBackupStamp

Il metodo SetBackupStamp imposta una stringa contenente informazioni che indicano quando si è verificato un backup.
IVssComponent::SetPostRestoreFailureMsg

Il metodo SetPostRestoreFailureMsg viene usato per creare un messaggio che descrive un errore nell'elaborazione di un evento PostRestore.
IVssComponent::SetPreRestoreFailureMsg

Il metodo SetPreRestoreFailureMsg viene usato per creare un messaggio che descrive un errore nell'elaborazione di un evento PreRestore.
IVssComponent::SetRestoreMetadata

Il metodo SetRestoreMetadata imposta metadati specifici del writer per il componente corrente.
IVssComponent::SetRestoreTarget

Il metodo SetRestoreTarget imposta la destinazione di ripristino (in termini di enumerazione VSS_RESTORE_TARGET) per il componente corrente.

Requisiti

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