Metodo IVssBackupComponents::D isableWriterClasses (vsbackup.h)
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 |
|---|---|
|
La classe writer è stata disabilitata correttamente. |
|
Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore. |
|
Il chiamante non è in memoria o altre risorse di sistema. |
|
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. |
|
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 |