IVssProviderCreateSnapshotSet::P reFinalCommitSnapshots-Methode (vsprov.h)
Die PreFinalCommitSnapshots-Methode ermöglicht Es Anbietern, Schattenkopien automatisch wiederherzustellen . Wenn für die Schattenkopie das flag VSS_VOLSNAP_ATTR_AUTORECOVER im Kontext festgelegt ist, kann das Volume während des automatischen Wiederherstellungsvorgangs eine große Anzahl von Schreibvorgängen empfangen.
Syntax
HRESULT PreFinalCommitSnapshots(
[in] VSS_ID SnapshotSetId
);
Parameter
[in] SnapshotSetId
Die VSS_ID , die den Schattenkopiensatz 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. |
|
Unerwarteter Anbieterfehler. Wenn dies zurückgegeben wird, muss der Fehler in einem Eintrag im Anwendungsereignisprotokoll beschrieben werden, der dem Benutzer Informationen zum Beheben des Problems gibt. |
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 wurde hinzugefügt, um die Binärkompatibilität zu ermöglichen, als das Feature für die automatische Wiederherstellung in Windows Server 2003 mit Service Pack 1 (SP1) eingeführt wurde.
Hinweis Für Windows Server 2003 wird empfohlen, dass Hardwareanbieter diese Methode mithilfe des folgenden Beispiels implementieren:
HRESULT PreFinalCommitSnapshots(
VSS_ID /* SnapshotSetId */
)
{
return S_OK;
}
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 |