Metodo IVssBackupComponents::SetBackupState (vsbackup.h)

  • Articolo

Il metodo SetBackupState definisce una configurazione complessiva per un'operazione di backup.

Sintassi

HRESULT SetBackupState(
  [in] bool            bSelectComponents,
  [in] bool            bBackupBootableSystemState,
  [in] VSS_BACKUP_TYPE backupType,
  [in] bool            bPartialFileSupport
);

Parametri

[in] bSelectComponents

Indica se un'operazione di backup o ripristino sarà in modalità componente.

L'operazione in modalità componente supporta il backup selettivo di singoli componenti designati (che possono consentire l'esclusione) o supporta solo il backup di tutti i file e componenti in un volume.

Il valore booleano è true se l'operazione verrà eseguita in modalità componente e false in caso contrario.

[in] bBackupBootableSystemState

Indica se viene eseguito un backup dello stato del sistema di avvio.

[in] backupType

Valore di enumerazione VSS_BACKUP_TYPE che indica il tipo di backup da eseguire.

[in] bPartialFileSupport

facoltativo. Se il valore di questo parametro è true, il supporto parziale dei file è abilitato. Il valore predefinito per questo argomento è false.

Valore restituito

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

Valore Significato
S_OK
 Impostare correttamente lo stato di backup.
E_INVALIDARG
 Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY
 Il chiamante non è in memoria o in 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 oppure questo metodo non è stato chiamato all'interno della sequenza corretta.
VSS_E_INVALID_XML_DOCUMENT
 Documento XML non valido. Per informazioni dettagliate, vedere il registro eventi. 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

Le applicazioni devono chiamare SetBackupState prima di chiamare IVssBackupComponents::P repareForBackup.

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

VSS_BACKUP_TYPE