Share via

IVssSoftwareSnapshotProvider::BeginPrepareSnapshot-Methode (vsprov.h)

  • Artikel

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

Syntax

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

Parameter

[in] SnapshotSetId

Bezeichner des Schattenkopiersatzes.

[in] SnapshotId

Bezeichner der zu erstellenden Schattenkopie.

[in] pwszVolumeName

Breitzeichenzeichenfolge mit NULL-Beendigung, die den Volumenamen enthält. Der Name muss in einem der folgenden Formate vorliegen und einen nachfolgenden umgekehrten Schrägstrich (\) enthalten:

  • Der Pfad eines eingebundenen Ordners, z. B. Y:\MountX\
  • Ein Laufwerkbuchstabe, z. B. D:\
  • Ein Volume-GUID-Pfad im Format \\?\Volume{GUID}\ (wobei GUID das Volume identifiziert)

[in] lNewContext

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

Rückgabewert

Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.

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 über nicht genügend 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 Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vsprov.h
Bibliothek VssApi.lib

Weitere Informationen

IVssSoftwareSnapshotProvider