IVssBackupComponentsEx2::BreakSnapshotSetEx-Methode (vsbackup.h)

  • Artikel

Durchbricht eine Schattenkopie gemäß den angegebenen Optionen der Anforderung.

Syntax

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

Parameter

[in] SnapshotSetID

Ein Schattenkopie-Set-Bezeichner.

[in] dwBreakFlags

Ein Bitmask von _VSS_HARDWARE_OPTIONS Flags, die angeben, wie der Schattenkopiesatz unterbrochen wird.

[out] ppAsync

Ein Zeiger auf eine Variable, die einen IVssAsync-Schnittstellenzeiger empfängt, der verwendet werden kann, um den Status des Schattenkopie-Setbruchvorgangs abzurufen. 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
0x0000000000L
 Der Schattenkopiesatz wurde erfolgreich unterbrochen.
E_ACCESSDENIED
0x8007005L
 Der Anrufer verfügt nicht über ausreichende Berechtigungen oder ist kein Administrator.
E_INVALIDARG
0x80070057L
 Eine der Parameterwerte ist ungültig.
E_OUTOFMEMORY
0x8007000EL
 Der Anrufer ist nicht im Arbeitsspeicher oder in anderen Systemressourcen vorhanden.
VSS_E_BREAK_REVERT_ID_FAILED
0x800423F6L
 Der Unterbrechungsvorgang für die Schattenkopie ist fehlgeschlagen, 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 ein oder mehrere ursprüngliche LUNs nicht auf dem Computer maskiert sind, würde der Unterbrechungsvorgang eine Signaturkollision verursachen.
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 unterbrochen 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 unterstützt, wenn Windows Server 2008 R2 und Windows 7. E_UNEXPECTED wird stattdessen verwendet.

Bemerkungen

BreakSnapshotSetEx ähnelt den IVssBackupComponents::BreakSnapshotSet-Methode , außer dass es zusätzliche Parameter zum Abfragen des Status hat und angeben, wie der Schattenkopiesatz unterbrochen wird.

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

Nachdem diese Methode zurückgegeben wurde, ist das Schattenkopievolume immer noch ein Volumen, aber es ist keine Schattenkopie mehr. Weitere Informationen finden Sie unter "Durchbruch von Schattenkopien".

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)