Metodo IVssBackupComponents::SetSelectedForRestore (vsbackup.h)
Il metodo SetSelectedForRestore indica se per il ripristino è selezionato il componente selezionabile specificato.
Sintassi
HRESULT SetSelectedForRestore(
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] bool bSelectedForRestore
);
Parametri
[in] writerId
Identificatore del writer.
[in] ct
Tipo del componente. Vedere VSS_COMPONENT_TYPE per i valori possibili.
[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 corrispondere a quello usato quando è stato aggiunto il componente.
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] bSelectedForRestore
Se il valore di questo parametro è true, il componente selezionato è stato selezionato per il ripristino. Se il valore è false, il componente selezionato non è stato selezionato per il ripristino.
Valore restituito
Di seguito sono riportati i codici restituiti validi per questo metodo.
| Valore | Significato |
|---|---|
|
È stato indicato che il componente specificato è stato selezionato per il ripristino. |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o in altre risorse di sistema. |
|
L'oggetto componenti di backup non viene inizializzato, questo metodo è stato chiamato durante un'operazione di ripristino oppure questo metodo non è stato chiamato all'interno della sequenza corretta. |
|
Il componente selezionato non esiste nel documento componenti di backup o un'istanza attiva del writer corrispondente a tale componente non è in esecuzione nel sistema. |
|
Documento XML non valido. Per informazioni dettagliate, vedere il registro eventi. 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
SetSelectedForRestore ha significato solo per i ripristini in modalità componente.
SetSelectedForRestore può essere chiamato solo per i componenti aggiunti in modo esplicito al documento di backup in fase di backup usando IVssBackupComponents::AddComponent. Il ripristino di un componente selezionato in modo implicito per il backup come parte di un set di componenti deve essere eseguito chiamando SetSelectedForRestore nel componente predecessore più vicino aggiunto al documento. Se devono essere ripristinati solo i dati di questo componente, è necessario eseguire questa operazione tramite IVssBackupComponents::AddRestoreSubcomponent; questa operazione può essere eseguita solo se il componente è selezionabile per il ripristino (vedere Uso della selezione e dei percorsi logici).
Questo metodo deve essere chiamato prima di IVssBackupComponents::P reRestore.
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 | vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h) |
| Libreria | VssApi.lib |
Vedi anche
IVssBackupComponents::P reRestore