IVssBackupComponentsEx2::BreakSnapshotSetEx-Methode (vsbackup.h)

Artikel
08/27/2023

Unterbricht einen Schattenkopiesatz gemäß den vom Anforderer angegebenen Optionen.

Syntax

HRESULT BreakSnapshotSetEx(
  [in]  VSS_ID    SnapshotSetID,
  [in]  DWORD     dwBreakFlags,
  [out] IVssAsync **ppAsync
);

Parameter

[in] SnapshotSetID

Ein Schattenkopiersatzbezeichner.

[in] dwBreakFlags

Eine Bitmaske mit _VSS_HARDWARE_OPTIONS Flags, die angeben, wie der Schattenkopiensatz unterbrochen wird.

[out] ppAsync

Ein Zeiger auf eine Variable, die einen IVssAsync-Schnittstellenzeiger empfängt, der zum Abrufen der status des Umbruchvorgangs für Schattenkopiersätze verwendet werden kann. Wenn der Unterbrechungsvorgang abgeschlossen ist, muss die IUnknown::Release-Methode für diesen Schnittstellenzeiger aufgerufen werden.

Rückgabewert

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

Wert	Bedeutung
S_OK 0x00000000L	Der Schattenkopiesatz wurde erfolgreich beschädigt.
E_ACCESSDENIED 0x80070005L	Der Aufrufer verfügt nicht über ausreichende Berechtigungen oder ist kein Administrator.
E_INVALIDARG 0x80070057L	Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY 0x8007000EL	Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_BREAK_REVERT_ID_FAILED 0x800423F6L	Fehler beim Umbruch des Schattenkopiersatzes, da die MBR-Datenträgersignatur, der GPT-Datenträgerbezeichner oder der GPT-Partitionsbezeichner einer oder mehrerer der Ziel-LUNs nicht auf die der ursprünglichen LUNs zurückgesetzt werden konnten. Wenn eine oder mehrere ursprüngliche LUNs auf dem Computer nicht maskiert sind, würde der Unterbrechungsvorgang zu einer Signaturkollision führen.
VSS_E_OBJECT_NOT_FOUND 0x80042308L	Die angegebene Schattenkopie ist nicht vorhanden.
VSS_E_PROVIDER_VETO 0x80042306L	Die Schattenkopie wurde von einem Softwareanbieter erstellt und kann nicht beschädigt werden.
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

BreakSnapshotSetEx ähnelt der IVssBackupComponents::BreakSnapshotSet-Methode, mit der Ausnahme, dass sie über zusätzliche Parameter verfügt, um status abzufragen und anzugeben, wie der Schattenkopiensatz unterbrochen wird.

Wie BreakSnapshotSet kann BreakSnapshotSetEx nur für Schattenkopien verwendet werden, die von einem Hardwareschattenkopieanbieter erstellt wurden.

Nachdem diese Methode zurückgegeben wurde, ist das Schattenkopievolume immer noch ein Volume, aber es ist keine Schattenkopie mehr. Weitere Informationen finden Sie unter Breaking Shadow Copies.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vsbackup.h (enthalten VsBackup.h, Vss.h, VsWriter.h)

Freigeben über