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

Artikel
08/27/2023

Committ alle Schattenkopien in diesem Satz gleichzeitig.

Syntax

HRESULT DoSnapshotSet(
  [out] IVssAsync **ppAsync
);

Parameter

[out] ppAsync

Ein doppelt indirekter Zeiger auf die erforderliche asynchrone IVssAsync-Schnittstelle . Dies wird verwendet, um den Ausführungsstatus der Methode abzufragen und den endgültigen Fehlercode abzurufen.

Rückgabewert

Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt. Diese Fehlercodes können von dieser Methode oder von der QueryStatus-Methode für die IVssAsync-Schnittstelle zurückgegeben werden, die im ppAsync-Parameter zurückgegeben wird.

Wert	Bedeutung
S_OK	Es wurde erfolgreich ein Zeiger auf eine instance der IVssAsync-Schnittstelle zurückgegeben. Die gültigen Werte, die vom pHrResult-Parameter zurückgegeben werden, finden Sie unter IVssAsync::QueryStatus.
E_ACCESSDENIED	Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator.
E_INVALIDARG	ppAsync zeigt nicht auf einen gültigen Zeiger. Das heißt, es ist NULL.
E_OUTOFMEMORY	Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen.
VSS_E_BAD_STATE	Das Sicherungskomponentenobjekt wurde nicht initialisiert, oder die erforderlichen Aufrufe für einen bestimmten Schattenkopiekontext wurden vor dem Aufrufen von DoSnapshotSet nicht ausgeführt.
VSS_E_INSUFFICIENT_STORAGE	Das System oder der Anbieter verfügt über unzureichenden Speicherplatz. Löschen Sie nach Möglichkeit alle alten oder unnötigen dauerhaften Schattenkopien, und versuchen Sie es erneut. Dieser Fehlercode wird nur über die QueryStatus-Methode für die IVssAsync-Schnittstelle zurückgegeben, die im ppAsync-Parameter zurückgegeben wird.
VSS_E_FLUSH_WRITES_TIMEOUT	Das System konnte E/A-Schreibvorgänge nicht leeren. Dies kann ein vorübergehendes Problem sein. Es wird empfohlen, zehn Minuten zu warten und es bis zu dreimal erneut zu versuchen.
VSS_E_HOLD_WRITES_TIMEOUT	Das System konnte E/A-Schreibvorgänge nicht halten. Dies kann ein vorübergehendes Problem sein. Es wird empfohlen, zehn Minuten zu warten und es bis zu dreimal erneut zu versuchen.
VSS_E_NESTED_VOLUME_LIMIT	Das angegebene Volume ist zu tief geschachtelt, um am VSS-Vorgang teilzunehmen. Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Rückgabecode wird nicht unterstützt.
VSS_E_PROVIDER_VETO	Der Anbieter konnte die Anforderung zu diesem Zeitpunkt nicht ausführen. Dies kann ein vorübergehendes Problem sein. Es wird empfohlen, zehn Minuten zu warten und es bis zu dreimal erneut zu versuchen. Dieser Fehlercode wird nur über die QueryStatus-Methode für die IVssAsync-Schnittstelle zurückgegeben, die im ppAsync-Parameter zurückgegeben wird.
VSS_E_REBOOT_REQUIRED	Beim Anbieter ist ein Fehler aufgetreten, der erfordert, dass der Benutzer den Computer neu starten muss. Windows Server 2003 und Windows XP: Dieser Wert wird nicht unterstützt.
VSS_E_TRANSACTION_FREEZE_TIMEOUT	Das System konnte den Distributed Transaction Coordinator (DTC) oder den KernelTransaktions-Manager (KTM) nicht einfrieren. Windows Server 2003 und Windows XP: Dieser Wert wird nicht unterstützt.
VSS_E_TRANSACTION_THAW_TIMEOUT	Das System konnte den Distributed Transaction Coordinator (DTC) oder den KernelTransaktions-Manager (KTM) nicht auftauen. Windows Server 2003 und Windows XP: Dieser Wert wird nicht unterstützt.
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.
VSS_E_UNEXPECTED_PROVIDER_ERROR	Der Anbieter hat einen unerwarteten Fehlercode zurückgegeben. Dies kann ein vorübergehendes Problem sein. Es wird empfohlen, zehn Minuten zu warten und es bis zu dreimal erneut zu versuchen. Dieser Fehlercode wird nur über die QueryStatus-Methode für die IVssAsync-Schnittstelle zurückgegeben, die im ppAsync-Parameter zurückgegeben wird.

Hinweise

Der Aufrufer ist für die Freigabe der IVssAsync-Schnittstelle verantwortlich.

Diese Methode kann nicht für eine virtuelle Festplatte (VHD) aufgerufen werden, die in einer anderen VHD geschachtelt ist.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: VHDs werden nicht unterstützt.

Informationen zur Verwendung von IVssBackupComponents::D oSnapshotSet zum Erstellen einer Standardmäßigen Sicherungsschattenkopie finden Sie unter Übersicht über Pre-Backup-Tasks und Erstellen einfacher Schattenkopien für die Sicherung. Informationen zur Verwendung der Methode in verschiedenen VSS-Kontexten finden Sie unter Implementierungsdetails zum Erstellen von Schattenkopien.

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