IVssProviderCreateSnapshotSet::CommitSnapshots-Methode (vsprov.h)

Die CommitSnapshots-Methode setzt schnell alle LUNs in diesem Anbieter fest.

Syntax

HRESULT CommitSnapshots(
  [in] VSS_ID SnapshotSetId
);

Die Parameter

[in] SnapshotSetId

Die VSS_ID , die den Schattenkopie-Satz identifiziert.

Rückgabewert

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

Bemerkungen

Diese Methode wird zum definierten Zeitpunkt aufgerufen, zu dem die Schattenkopien aufgenommen werden sollen. Für jede vorbereitete LUN in diesem Schattenkopiensatz führt der Anbieter die erforderliche Arbeit aus, um den LUN-Inhalt der Uhrzeit beizubehalten. Während diese Methode ausgeführt wird, sind sowohl Anwendungen als auch das E/A-Subsystem weitgehend still. Der Anbieter muss die in dieser Methode aufgewendete Zeit minimieren. In der Regel sollte diese Methode weniger als eine Sekunde dauern. Diese Methode wird während des Fensters "Leeren" und "Halten" aufgerufen, und die VSS-Kernelunterstützung bricht das Flush and Hold-Element ab, wenn die Freigabe nicht innerhalb von 10 Sekunden empfangen wird, was dazu führen würde, dass VSS den Erstellungsprozess der Schattenkopie fehlschlägt. Wenn jeder Anbieter mehr als eine Sekunde oder zwei benötigt, um diesen Aufruf abzuschließen, besteht eine hohe Wahrscheinlichkeit, dass die gesamte Erstellung der Schattenkopie fehlschlägt.

Da das E/A-System stillzulegen ist, muss der Anbieter darauf achten, keine E/A zu initiieren, da es das System inaktivieren könnte , z. B. Debuggen oder Nachverfolgen von E/A durch diese Methode oder aufrufe von dieser Methode. Die zugeordneten Speicherdateien und die Auslagerungs-E/A werden zurzeit nicht fixiert.

Beachten Sie, dass das E/A-System nur während der Ausführung dieser Methode stilllegen ist. Unmittelbar nach dem Zurückgeben der CommitSnapshots-Methode des letzten Anbieters veröffentlicht der VSS-Dienst alle ausstehenden Schreibvorgänge für die Quell-LUNs. Wenn der Anbieter eine Synchronisierung der Quell- und Schattenkopie-LUNs durchführt, muss diese Synchronisierung abgeschlossen werden, bevor die CommitSnapshots-Methode des Anbieters zurückgegeben wird; sie kann nicht asynchron ausgeführt werden.

Anforderungen

Siehe auch

IVssProviderCreateSnapshotSet