Metodo IVssBackupComponents::D isableWriterInstances (vsbackup.h)

Articolo
08/27/2023

Il metodo DisableWriterInstances disabilita un'istanza o un'istanza di writer specificata.

Sintassi

HRESULT DisableWriterInstances(
  [in] const VSS_ID *rgWriterInstanceId,
  [in] UINT         cInstanceId
);

Parametri

[in] rgWriterInstanceId

Matrice contenente uno o più identificatori di istanza del writer.

[in] cInstanceId

Numero di voci nella matrice rgWriterInstanceId .

Valore restituito

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

Valore	Significato
S_OK	La classe writer è stata abilitata 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 un'istanza di un writer non causa la disabilitazione delle altre istanze del writer.

Se si chiama DisableWriterInstances, è necessario eseguire questa operazione prima di chiamare il metodo IVssBackupComponents::GatherWriterMetadata . Se si chiama GatherWriterMetadata prima e quindi si chiama DisableWriterInstances, la chiamata a DisableWriterInstances non ha alcun effetto. Se è prima necessario chiamare GatherWriterMetadata , per determinare quali istanze del writer disabilitare, è 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::EnableWriterClasses

IVssBackupComponents::GatherWriterMetadata

Condividi tramite