Metodo IVssBackupComponents::SetRestoreOptions (vsbackup.h)

Articolo
08/27/2023

Il metodo SetRestoreOptions imposta una stringa di parametri privati o dipendenti dal writer per un componente writer.

Sintassi

HRESULT SetRestoreOptions(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] LPCWSTR            wszRestoreOptions
);

Parametri

[in] writerId

Identificatore 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] wszRestoreOptions

Stringa di caratteri wide con terminazione null contenente la stringa privata dei parametri di ripristino. Per altre informazioni, vedere Impostazione delle opzioni di ripristino di VSS.

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo.

Valore	Significato
S_OK	Impostare correttamente il timestamp di backup precedente.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_BAD_STATE	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.
VSS_E_OBJECT_NOT_FOUND	Il componente di backup non esiste.
VSS_E_INVALID_XML_DOCUMENT	Il documento XML non è valido. Controllare il registro eventi per informazioni dettagliate. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
VSS_E_UNEXPECTED	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

Questo metodo deve essere chiamato prima di IVssBackupComponents::P reRestore.

La sintassi esatta e il contenuto delle opzioni di ripristino impostate dal parametro wszRestoreOptions del metodo SetRestoreOptions dipenderà dal writer specifico contattato.

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

IVssBackupComponents::P reStore

VSS_COMPONENT_TYPE

Condividi tramite