IVssBackupComponents::D isableWriterClasses-Methode (vsbackup.h)

Artikel
08/27/2023

Die DisableWriterClasses-Methode verhindert, dass eine bestimmte Klasse von Writern Ereignisse empfängt.

Syntax

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

Parameter

[in] rgWriterClassId

Ein Array, das mindestens einen Writer-Klassenbezeichner enthält.

[in] cClassId

Die Anzahl der Einträge im Array rgWriterClassId .

Rückgabewert

Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.

Wert	Bedeutung
S_OK	Die Writer-Klasse wurde erfolgreich deaktiviert.
E_ACCESSDENIED	Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator.
E_OUTOFMEMORY	Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen.
VSS_E_BAD_STATE	Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht in der richtigen Sequenz aufgerufen.
VSS_E_UNEXPECTED	Unerwarteter Fehler. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet.

Hinweise

Wenn Sie über mehrere ausgeführte Kopien desselben Writers verfügen, verfügen alle über denselben Writer-Klassenbezeichner, aber sie verfügen über unterschiedliche Writer-instance-Bezeichner. Das Deaktivieren einer Writer-Klasse führt dazu, dass alle Instanzen des Writers deaktiviert werden.

Wenn die DisableWriterClasses-Methode und die IVssBackupComponents::EnableWriterClasses-Methode nie aufgerufen werden, werden alle Writer-Klassen aktiviert.

Nachdem der erste Aufruf von DisableWriterClasses zurückgegeben wurde, sind die im Array rgWriterClassId angegebenen Writer-Klassen deaktiviert, und alle anderen Writer-Klassen sind aktiviert.

Wenn Sie DisableWriterClasses mehrmals aufrufen, fügt jeder Aufruf die Writer im Array rgWriterClassId der Liste der deaktivierten Autoren hinzu.

Wenn Sie DisableWriterClasses mehrmals aufrufen und dann EnableWriterClasses aufrufen, wird mit dem ersten Aufruf von EnableWriterClasses die Wirkung der Aufrufe von DisableWriterClasses abgebrochen und nur die Writer im Array rgWriterClassId aktiviert.

Wenn Sie DisableWriterClasses aufrufen, müssen Sie dies vor dem Aufrufen der IVssBackupComponents::GatherWriterMetadata-Methode tun. Wenn Sie zuerst GatherWriterMetadata und dann DisableWriterClasses aufrufen, hat der Aufruf von DisableWriterClasses keine Auswirkung. Wenn Sie GatherWriterMetadata zuerst aufrufen müssen, müssen Sie es von einer anderen instance der IVssBackupComponents-Schnittstelle aufrufen, um zu bestimmen, welche Writer-Klassen deaktiviert werden sollen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vsbackup.h (einschließlich VsBackup.h, Vss.h, VsWriter.h)
Bibliothek	VssApi.lib

Weitere Informationen

IVssBackupComponents

IVssBackupComponents::D isableWriterInstances

IVssBackupComponents::EnableWriterClasses

Share via