Metodo IVssBackupComponents::D isableWriterClasses (vsbackup.h)

  • Articolo

Il metodo DisableWriterClasses impedisce a una classe specifica di writer di ricevere eventuali eventi.

Sintassi

HRESULT DisableWriterClasses(
  [in] const VSS_ID *rgWriterClassId,
  [in] UINT         cClassId
);

Parametri

[in] rgWriterClassId

Matrice contenente uno o più identificatori di classe writer.

[in] cClassId

Numero di voci nella matrice rgWriterClassId .

Valore restituito

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

Valore Significato
S_OK
 La classe writer è stata disabilitata correttamente.
E_ACCESSDENIED
 Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore.
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_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

Se si dispone di più copie in esecuzione dello stesso writer, tutte avranno lo stesso identificatore della classe writer, ma avranno identificatori di istanza del writer diversi. La disabilitazione di una classe writer causa la disabilitazione di tutte le istanze del writer.

Se il metodo DisableWriterClasses e il metodo IVssBackupComponents::EnableWriterClasses non vengono mai chiamati, tutte le classi writer sono abilitate.

Dopo aver restituito la prima chiamata a DisableWriterClasses , le classi writer specificate nella matrice rgWriterClassId sono disabilitate e tutte le altre classi writer sono abilitate.

Se si chiama DisableWriterClasses più volte, ogni chiamata aggiunge i writer nella matrice rgWriterClassId all'elenco di writer disabilitati.

Se si chiama DisableWriterClasses una o più volte e quindi si chiama EnableWriterClasses, la prima chiamata a EnableWriterClasses annulla l'effetto delle chiamate a DisableWriterClasses e abilita solo i writer nella matrice rgWriterClassId.

Se si chiama DisableWriterClasses, è necessario eseguire questa operazione prima di chiamare il metodo IVssBackupComponents::GatherWriterMetadata . Se si chiama GatherWriterMetadata prima e quindi si chiama DisableWriterClasses, la chiamata a DisableWriterClasses non ha alcun effetto. Se è prima necessario chiamare GatherWriterMetadata , per determinare quali classi writer disabilitare, è necessario chiamarla da un'istanza diversa dell'interfaccia IVssBackupComponents .

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::D isableWriterInstances

IVssBackupComponents::EnableWriterClasses