IVssBackupComponents::D isableWriterClasses-Methode (vsbackup.h)
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 |
|---|---|
|
Die Writer-Klasse wurde erfolgreich deaktiviert. |
|
Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator. |
|
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht in der richtigen Sequenz aufgerufen. |
|
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 |