IVssBackupComponents::EnableWriterClasses-Methode (vsbackup.h)

  • Artikel

Mit der EnableWriterClasses-Methode können die angegebenen Autoren alle Ereignisse empfangen.

Syntax

HRESULT EnableWriterClasses(
  [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 aktiviert.
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 die EnableWriterClasses-Methode und die IVssBackupComponents::D isableWriterClasses-Methode nie aufgerufen werden, werden alle Writer-Klassen aktiviert.

Nachdem der erste Aufruf von EnableWriterClasses zurückgegeben wurde, werden die writer-Klassen aktiviert, die im Array rgWriterClassId angegeben wurden, und alle anderen Writer-Klassen sind deaktiviert.

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

Wenn Sie EnableWriterClasses mehrmals aufrufen und anschließend DisableWriterClasses aufrufen, werden mit dem Aufruf von DisableWriterClasses alle Autoren im Array rgWriterClassId deaktiviert, die in den Aufrufen von EnableWriterClasses aktiviert wurden.

Wenn Sie EnableWriterClasses aufrufen, müssen Sie dies vor dem Aufrufen der IVssBackupComponents::GatherWriterMetadata-Methode tun. Wenn Sie zuerst GatherWriterMetadata und dann EnableWriterClasses aufrufen, hat der Aufruf von EnableWriterClasses keine Auswirkungen. Wenn Sie GatherWriterMetadata zuerst aufrufen müssen, müssen Sie es über eine andere instance der IVssBackupComponents-Schnittstelle aufrufen, um zu ermitteln, welche Writer-Klassen aktiviert werden sollen.

Anforderungen

Anforderung Wert
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 isableWriterClasses

IVssBackupComponents::D isableWriterInstances