Méthode IVssSoftwareSnapshotProvider ::SetContext (vsprov.h)

  • Article

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
S_OK
 Le contexte a été correctement défini.
E_ACCESSDENIED
 L’appelant ne dispose pas de privilèges de sauvegarde suffisants ou n’est pas administrateur.
E_INVALIDARG
 L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY
 L’appelant n’a plus de mémoire ou d’autres ressources système.
VSS_E_BAD_STATE
 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

Voir aussi

IVssSoftwareSnapshotProvider