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 |
|---|---|
|
Der Kontext wurde erfolgreich festgelegt. |
|
Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen. |
|
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 |