Metodo IVssBackupComponentsEx2::SetAuthoritativeRestore (vsbackup.h)

  • Articolo

Contrassegna il ripristino di un componente come autorevole per un archivio dati replicato.

Sintassi

HRESULT SetAuthoritativeRestore(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] bool               bAuth
);

Parametri

[in] writerId

Identificatore univoco globale (GUID) della classe writer.

[in] ct

Tipo del componente. Vedere l'enumerazione 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 alla stringa usata al momento dell'aggiunta del 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 il metodo IVssBackupComponents::AddComponent .

[in] bAuth

Impostare questa variabile su true per indicare che il ripristino del componente è autorevole o false in caso contrario.

Il valore predefinito è false.

Valore restituito

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

Valore Significato
S_OK
 Il ripristino del componente è stato impostato correttamente su autorevole o non autenticativo.
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
 Questo metodo non è stato chiamato durante un'operazione di ripristino.
VSS_E_OBJECT_NOT_FOUND
 Impossibile trovare il componente specificato.
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

Il metodo SetAuthoritativeRestore può essere chiamato solo durante un'operazione di ripristino.

Un writer indica che supporta il ripristino autorevole impostando il flag VSS_BS_AUTHORITATIVE_RESTORE nella maschera dello schema di backup.

Per altre informazioni, vedere Impostazione delle opzioni di ripristino vss.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)
Libreria VssApi.lib

Vedi anche

IVssBackupComponents::SetRestoreOptions

IVssBackupComponentsEx2

IVssComponentEx::GetAuthoritativeRestore

VSS_BACKUP_SCHEMA