Méthode IVssSoftwareSnapshotProvider ::SetContext (vsprov.h)
Définit le contexte pour les opérations ultérieures 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 une combinaison prise en charge de valeurs _VSS_VOLUME_SNAPSHOT_ATTRIBUTES et _VSS_SNAPSHOT_CONTEXT .
Valeur retournée
Voici les codes de retour valides pour cette méthode.
| Valeur | Signification |
|---|---|
|
Le contexte a été correctement défini. |
|
L’appelant ne dispose pas de privilèges de sauvegarde suffisants ou n’est pas administrateur. |
|
L’une des valeurs de paramètre n’est pas valide. |
|
L’appelant n’a plus de mémoire ou d’autres ressources système. |
|
Le contexte est figé et ne peut pas être modifié. |
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.
Pour plus d’informations sur la façon dont le contexte défini par SetContext affecte la création et la gestion d’un cliché instantané, 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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | vsprov.h |
| Bibliothèque | VssApi.lib |