Metodo IVssBackupComponents::EnableWriterClasses (vsbackup.h)

Articolo
08/27/2023

Il metodo EnableWriterClasses consente ai writer specificati di ricevere tutti gli eventi.

Sintassi

HRESULT EnableWriterClasses(
  [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 abilitata.
E_ACCESSDENIED	Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore.
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_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 il metodo EnableWriterClasses e il metodo IVssBackupComponents::D isableWriterClasses non vengono mai chiamati, tutte le classi writer sono abilitate.

Al termine della prima chiamata a EnableWriterClasses , le classi writer specificate nella matrice rgWriterClassId sono abilitate e tutte le altre classi writer sono disabilitate.

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

Se si chiama EnableWriterClasses una o più volte e quindi si chiama DisableWriterClasses, la chiamata a DisableWriterClasses disabilita tutti i writer nella matrice rgWriterClassId abilitati nelle chiamate a EnableWriterClasses.

Se chiami EnableWriterClasses, devi farlo prima di chiamare il metodo IVssBackupComponents::GatherWriterMetadata . Se si chiama GatherWriterMetadata prima e quindi si chiama EnableWriterClasses, la chiamata a EnableWriterClasses non ha alcun effetto. Se è prima necessario chiamare GatherWriterMetadata , per determinare le classi writer da abilitare, è necessario chiamarla da un'istanza diversa dell'interfaccia IVssBackupComponents .

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

IVssBackupComponents::D isableWriterClasses

IVssBackupComponents::D isableWriterInstances

Condividi tramite