IVssBackupComponents::StartSnapshotSet-Methode (vsbackup.h)

Die StartSnapshotSet-Methode erstellt einen neuen, leeren Schattenkopiensatz.

Syntax

HRESULT StartSnapshotSet(
  [out] VSS_ID *pSnapshotSetId
);

Parameter

[out] pSnapshotSetId

Die Adresse einer vom Aufrufer zugeordneten Variablen, die den Bezeichner des Schattenkopiensatzes empfängt.

Rückgabewert

Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.

Wert Bedeutung
S_OK
Der Schattenkopiersatz wurde erfolgreich gestartet.
E_INVALIDARG
Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
Der Aufrufer verfügt über nicht genügend 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 innerhalb der richtigen Sequenz aufgerufen.
VSS_E_SNAPSHOT_SET_IN_PROGRESS
Die Erstellung einer Schattenkopie wird ausgeführt, und es kann jeweils nur ein Vorgang zur Erstellung von Schattenkopien ausgeführt werden. Warten Sie, um es erneut zu versuchen, oder kehren Sie mit einem Fehlerfehlercode zurück.
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

Diese Methode muss vor IVssBackupComponents::P repareForBackup während Sicherungsvorgängen aufgerufen werden.

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

IVssBackupComponents::P repareForBackup