IVssBackupComponents::EnableWriterClasses-Methode (vsbackup.h)
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 |
|---|---|
|
Die Writer-Klasse wurde erfolgreich aktiviert. |
|
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 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 |