Méthode IVssBackupComponents::SetContext (vsbackup.h)
La méthode SetContext définit le contexte pour les opérations suivantes liées au cliché instantané.
Syntaxe
HRESULT SetContext(
[in] LONG lContext
);
Paramètres
[in] lContext
Contexte à définir. Le contexte doit être l’une des valeurs prises en charge de _VSS_SNAPSHOT_CONTEXT ou un masque de bits pris en charge (ou au niveau du bit OR) de _VSS_VOLUME_SNAPSHOT_ATTRIBUTES avec un _VSS_SNAPSHOT_CONTEXT valide.
Valeur retournée
La valeur de retour par défaut de cette méthode est S_OK. Voici les codes de retour valides pour cette méthode.
| Valeur | Signification |
|---|---|
|
Définissez correctement le contexte. |
|
L’une des valeurs de paramètre n’est pas valide. |
|
L’objet de composants de sauvegarde n’est pas initialisé, cette méthode a été appelée pendant une opération de restauration ou cette méthode n’a pas été appelée dans la séquence correcte. |
|
Erreur inattendue. Le code d’erreur est enregistré dans le fichier journal des erreurs. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge tant que Windows Server 2008 R2 et Windows 7. E_UNEXPECTED est utilisé à la place. |
Remarques
Le contexte par défaut pour les clichés instantanés VSS est VSS_CTX_BACKUP.
Windows XP : Le seul contexte pris en charge est le contexte par défaut, VSS_CTX_BACKUP. Par conséquent, l’appel de SetContext sous Windows XP renvoie E_NOTIMPL.
SetContext ne peut être appelé qu’une seule fois, et il doit être appelé avant d’appeler la plupart des fonctions VSS.
Pour plus d’informations sur la façon dont le contexte défini par IVssBackupComponents::SetContext affecte la façon dont un cliché instantané est créé et géré, consultez Détails de l’implémentation pour la création de clichés instantanés.
Pour une présentation complète des contextes de cliché instantané autorisés, consultez _VSS_SNAPSHOT_CONTEXT et _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.
Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | vsbackup.h (inclure VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothèque | VssApi.lib |
Voir aussi
IVssBackupComponents::D oSnapshotSet