Metodo IVssBackupComponents::D isableWriterInstances (vsbackup.h)

  • Articolo

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