IVssBackupComponents::SetContext-Methode (vsbackup.h)
Die SetContext-Methode 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 einer unterstützten Bitmaske (oder bitweisen OR) von _VSS_VOLUME_SNAPSHOT_ATTRIBUTES mit einer gültigen _VSS_SNAPSHOT_CONTEXT sein.
Rückgabewert
Der Standardrückgabewert dieser Methode ist S_OK. Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Der Kontext wurde erfolgreich festgelegt. |
|
Einer der Parameterwerte ist ungültig. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht innerhalb der richtigen Sequenz aufgerufen. |
|
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. |
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 der Aufruf von SetContext unter Windows XP E_NOTIMPL zurück.
SetContext kann nur einmal aufgerufen werden und muss vor dem Aufrufen der meisten VSS-Funktionen aufgerufen werden.
Ausführliche Informationen dazu, wie sich der von IVssBackupComponents::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
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsbackup.h (enthalten VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |
Weitere Informationen
IVssBackupComponents::D oSnapshotSet