Freigeben über


IVssProviderCreateSnapshotSet::P reFinalCommitSnapshots-Methode (vsprov.h)

Mit der PreFinalCommitSnapshots-Methode können Anbieter Schattenkopien automatisch wiederherstellen . Wenn die Schattenkopie das im Kontext festgelegte VSS_VOLSNAP_ATTR_AUTORECOVER Flag aufweist, kann das Volume während des automatischen Wiederherstellungsvorgangs eine große Anzahl von Schreibvorgängen empfangen.

Syntax

HRESULT PreFinalCommitSnapshots(
  [in] VSS_ID SnapshotSetId
);

Die Parameter

[in] SnapshotSetId

Die VSS_ID , die den Schattenkopie-Satz identifiziert.

Rückgabewert

Zurückgeben von Code/Wert Description
S_OK
0x000000000L
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_PROVIDER_VETO
0x80042306L
Unerwarteter Anbieterfehler. Wenn dies zurückgegeben wird, muss der Fehler in einem Eintrag im Anwendungsereignisprotokoll beschrieben werden und dem Benutzer Informationen zur Behebung des Problems geben.
 

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 wurde hinzugefügt, um die binäre Kompatibilität zu aktivieren, wenn das Feature für die automatische Wiederherstellung in Windows Server 2003 mit Service Pack 1 (SP1) eingeführt wurde.

Anmerkung Für Windows Server 2003 wird empfohlen, diese Methode mithilfe des folgenden Beispiels zu implementieren:
 
HRESULT PreFinalCommitSnapshots(
VSS_ID     /* SnapshotSetId */
)
{
    return S_OK;
}

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2003 [Nur Desktop-Apps]
Zielplattform Fenster
Header vsprov.h

Siehe auch

IVssProviderCreateSnapshotSet