Freigeben über


IVssProviderCreateSnapshotSet::CommitSnapshots-Methode (vsprov.h)

Die CommitSnapshots-Methode committ schnell alle LUNs in diesem Anbieter.

Syntax

HRESULT CommitSnapshots(
  [in] VSS_ID SnapshotSetId
);

Parameter

[in] SnapshotSetId

Die VSS_ID , die den Schattenkopiersatz identifiziert.

Rückgabewert

Rückgabecode/-wert BESCHREIBUNG
S_OK
0x00000000L
Der Vorgang wurde erfolgreich abgeschlossen.
E_OUTOFMEMORY
0x8007000EL
Nicht genügend Arbeitsspeicher oder andere Systemressourcen.
E_INVALIDARG
0x80070057L
Einer der Parameterwerte ist ungültig.
VSS_E_OBJECT_NOT_FOUND
0x80042308L
Der SnapshotSetId-Parameter verweist auf ein Objekt, das nicht gefunden wurde.
VSS_E_PROVIDER_VETO
0x80042306L
Ein unerwarteter Anbieterfehler ist aufgetreten. Der Anbieter muss die Details dieses Fehlers im Anwendungsereignisprotokoll protokollieren.
 

Wenn ein anderer Wert zurückgegeben wird, schreibt VSS ein Ereignis in das Ereignisprotokoll und konvertiert den Fehler in VSS_E_UNEXPECTED_PROVIDER_ERROR.

Hinweise

Diese Methode wird zu dem definierten Zeitpunkt aufgerufen, zu dem die Schattenkopien erstellt werden sollen. Für jede vorbereitete LUN in diesem Schattenkopiensatz führt der Anbieter die zum Beibehalten des Point-in-Time-LUN-Inhalts erforderliche Arbeit aus. Während diese Methode ausgeführt wird, sind sowohl Anwendungen als auch das E/A-Subsystem weitgehend still. Der Anbieter muss den Zeitaufwand für diese Methode minimieren. In der Regel sollte die Ausführung dieser Methode weniger als eine Sekunde dauern. Diese Methode wird während des Fensters Flush and Hold aufgerufen, und die VSS-Kernelunterstützung bricht die Leerung und das Halten ab, wenn das Release nicht innerhalb von 10 Sekunden empfangen wird, was dazu führen würde, dass VSS beim Erstellungsprozess für Schattenkopien fehlschlägt. Wenn jeder Anbieter mehr als eine oder zwei Sekunden benötigt, um diesen Aufruf abzuschließen, ist die Wahrscheinlichkeit hoch, dass die gesamte Schattenkopieerstellung fehlschlägt.

Da das E/A-System ruhend ist, muss der Anbieter darauf achten, keine E/A-Vorgänge zu initiieren, da er das System deadlocken könnte , z. B. Debuggen oder Ablaufverfolgung von E/A durch diese Methode oder alle Aufrufe dieser Methode. Speicherzuordnungsdateien und Paging-E/A werden derzeit nicht eingefroren.

Beachten Sie, dass das E/A-System nur während der Ausführung dieser Methode still ist. Unmittelbar nachdem die CommitSnapshots-Methode des letzten Anbieters zurückgegeben wurde, gibt der VSS-Dienst alle ausstehenden Schreibvorgänge für die Quell-LUNs frei. Wenn der Anbieter eine Synchronisierung der Quell- und Schattenkopie-LUNs durchführt, muss diese Synchronisierung abgeschlossen sein, bevor die CommitSnapshots-Methode des Anbieters zurückgibt. Sie kann nicht asynchron ausgeführt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vsprov.h

Weitere Informationen

IVssProviderCreateSnapshotSet