IVssFileShareSnapshotProvider::BeginPrepareSnapshot-Methode (vsprov.h)

VSS ruft diese Methode für jede Schattenkopie auf, die dem Schattenkopiersatz hinzugefügt wird.

Syntax

HRESULT BeginPrepareSnapshot(
  [in] VSS_ID   SnapshotSetId,
  [in] VSS_ID   SnapshotId,
  [in] VSS_PWSZ pwszSharePath,
  [in] LONG     lNewContext,
  [in] VSS_ID   ProviderId
);

Parameter

[in] SnapshotSetId

Bezeichner des Schattenkopiersatzes.

[in] SnapshotId

Bezeichner der zu erstellenden Schattenkopie.

[in] pwszSharePath

Der Dateifreigabepfad.

[in] lNewContext

Der Kontext für den Schattenkopiersatz. Dieser Kontext besteht aus einer Bitmaske von _VSS_VOLUME_SNAPSHOT_ATTRIBUTES Werten.

[in] ProviderId

Die Anbieter-ID.

Rückgabewert

Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.

Wert	Bedeutung
S_OK	Die Schattenkopie wurde erfolgreich erstellt.
E_ACCESSDENIED	Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator.
E_INVALIDARG	Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY	Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen.
VSS_E_OBJECT_NOT_FOUND	Das angegebene Volume wurde nicht gefunden.
VSS_E_PROVIDER_VETO	Anbieterfehler. Der Anbieter hat den Fehler im Ereignisprotokoll protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
VSS_E_UNSUPPORTED_CONTEXT	Der angegebene Kontext wird nicht unterstützt.
VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER	Der Anbieter unterstützt das angegebene Volume nicht.
VSS_E_UNEXPECTED	Unerwarteter Fehler. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vsprov.h
Bibliothek	VssApi.lib

Weitere Informationen

IVssFileShareSnapshotProvider