IVssBackupComponents::D oSnapshotSet-Methode (vsbackup.h)
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 |
|---|---|
|
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. |
|
Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator. |
|
ppAsync zeigt nicht auf einen gültigen Zeiger. Das heißt, es ist NULL. |
|
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen. |
|
Das Sicherungskomponentenobjekt wurde nicht initialisiert, oder die erforderlichen Aufrufe für einen bestimmten Schattenkopiekontext wurden vor dem Aufrufen von DoSnapshotSet nicht ausgeführt. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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 |
Weitere Informationen
IVssBackupComponents::AddComponent
IVssBackupComponents::AddToSnapshotSet