IVssSoftwareSnapshotProvider::SetContext-Methode (vsprov.h)

Legt den Kontext für nachfolgende Vorgänge im Zusammenhang mit Schattenkopien fest.

Syntax

HRESULT SetContext(
  [in] LONG lContext
);

Parameter

[in] lContext

Der festzulegende Kontext. Der Kontext muss einer der unterstützten Werte von _VSS_SNAPSHOT_CONTEXT oder eine unterstützte Kombination aus _VSS_VOLUME_SNAPSHOT_ATTRIBUTES - und _VSS_SNAPSHOT_CONTEXT-Werten sein.

Rückgabewert

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

Wert	Bedeutung
S_OK	Der Kontext wurde erfolgreich festgelegt.
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_BAD_STATE	Der Kontext ist eingefroren und kann nicht geändert werden.

Hinweise

Der Standardkontext für VSS-Schattenkopien ist VSS_CTX_BACKUP.

Windows XP: Der einzige unterstützte Kontext ist der Standardkontext, VSS_CTX_BACKUP. Daher gibt das Aufrufen von SetContext unter Windows XP E_NOTIMPL zurück.

Weitere Informationen dazu, wie sich der von SetContext festgelegte Kontext auf das Erstellen und Verwalten einer Schattenkopie auswirkt, finden Sie unter Implementierungsdetails zum Erstellen von Schattenkopien.

Eine vollständige Erläuterung der zulässigen Schattenkopiekontexte finden Sie unter _VSS_SNAPSHOT_CONTEXT und _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.

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