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 :

• IVssWriterComponents::GetComponent
• IVssWriterComponentsExt::GetComponent

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)