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 |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Einer der Parameterwerte ist ungültig. |
|
Der SnapshotSetId-Parameter verweist auf ein Objekt, das nicht gefunden wurde. |
|
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 |