Metodo IVssBackupComponents::SetBackupSucceededed (vsbackup.h)
Il metodo SetBackupSucceeded indica se il backup del componente specificato di un writer specifico ha avuto esito positivo.
Sintassi
HRESULT SetBackupSucceeded(
[in] VSS_ID instanceId,
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] bool bSucceded
);
Parametri
[in] instanceId
Identificatore univoco globale (GUID) dell'istanza del writer.
[in] writerId
Identificatore univoco globale (GUID) della classe writer.
[in] ct
Tipo del componente. Per i valori possibili, vedere VSS_COMPONENT_TYPE .
[in] wszLogicalPath
Stringa di caratteri wide con terminazione Null contenente il percorso logico del componente.
Per altre informazioni, vedere Percorso logico dei componenti.
Il valore della stringa contenente il percorso logico usato qui deve essere uguale a quello usato quando il componente è stato aggiunto al set di backup usando IVssBackupComponents::AddComponent.
Il percorso logico può essere NULL.
Non esistono restrizioni sui caratteri che possono essere visualizzati in un percorso logico non NULL .
[in] wszComponentName
Stringa di caratteri wide con terminazione null contenente il nome del componente.
La stringa non può essere NULL e deve contenere lo stesso nome del componente usato quando il componente è stato aggiunto al set di backup usando IVssBackupComponents::AddComponent.
[in] bSucceded
Impostare questo parametro su true se il componente è stato eseguito correttamente il backup o false in caso contrario.
Valore restituito
Di seguito sono riportati i codici restituiti validi per questo metodo.
| Valore | Significato |
|---|---|
|
Impostare correttamente lo stato di backup riuscito. |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o altre risorse di sistema. |
|
L'oggetto componenti di backup non viene inizializzato, questo metodo è stato chiamato durante un'operazione di ripristino o questo metodo non è stato chiamato all'interno della sequenza corretta. |
|
Il componente di backup non esiste. |
|
Il documento XML non è valido. Controllare il registro eventi per informazioni dettagliate. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. |
|
Errore imprevisto. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008 R2 e Windows 7. E_UNEXPECTED viene invece usato. |
Commenti
Quando si lavora in modalità componente (quando IVssBackupComponents::SetBackupState viene chiamato con il relativo argomento dei componenti selezionati impostato su true), i writer controllano lo stato di ogni backup dei componenti usando IVssComponent::GetBackupSucceeded. Pertanto, un'applicazione di backup ben comportata (richiedente) deve chiamare SetBackupSucceed dopo che ogni componente è stato elaborato e prima di chiamare IVssBackupComponents::BackupComplete.
Non chiamare questo metodo se la chiamata a IVssBackupComponents::D oSnapshotSet non è riuscita. Per altre informazioni sul modo in cui i richiedenti usano DoSnapshotSet, SetBackupSucceeded e BackupComplete in un'operazione di backup, vedere Panoramica delle attività di pre-backup e panoramica del backup effettivo dei file.
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) |
| Libreria | VssApi.lib |
Vedi anche
IVssBackupComponents::BackupComplete