IVssBackupComponents::D isableWriterInstances-Methode (vsbackup.h)
Die DisableWriterInstances-Methode deaktiviert einen angegebenen Writer instance oder Instanzen.
Syntax
HRESULT DisableWriterInstances(
[in] const VSS_ID *rgWriterInstanceId,
[in] UINT cInstanceId
);
Parameter
[in] rgWriterInstanceId
Ein Array, das einen oder mehrere Writer-instance-Bezeichner enthält.
[in] cInstanceId
Die Anzahl der Einträge im rgWriterInstanceId-Array .
Rückgabewert
Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Die Writer-Klasse wurde erfolgreich aktiviert. |
|
Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator. |
|
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht innerhalb 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 instance eines Writers führt nicht dazu, dass die anderen Instanzen des Writers deaktiviert werden.
Wenn Sie DisableWriterInstances aufrufen, müssen Sie dies tun, bevor Sie die IVssBackupComponents::GatherWriterMetadata-Methode aufrufen. Wenn Sie zuerst GatherWriterMetadata und dann DisableWriterInstances aufrufen, hat der Aufruf von DisableWriterInstances keine Auswirkungen. Wenn Sie GatherWriterMetadata zuerst aufrufen müssen, um zu bestimmen, welche Writer-Instanzen deaktiviert werden sollen, müssen Sie es aus einem anderen instance der IVssBackupComponents-Schnittstelle aufrufen.
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 (enthalten VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |
Weitere Informationen
IVssBackupComponents::D isableWriterClasses