IVssSoftwareSnapshotProvider::SetContext, méthode (vsprov.h)

  • Article
  • 2 minutes de lecture

Définit le contexte pour les opérations liées à la copie instantanée ultérieures.

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 _VSS_VOLUME_SNAPSHOT_ATTRIBUTES et de valeurs _VSS_SNAPSHOT_CONTEXT .

Valeur retournée

Voici les codes de retour valides pour cette méthode.

Valeur Signification
S_OK
 Le contexte a été défini avec succès.
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 est hors mémoire ou d’autres ressources système.
VSS_E_BAD_STATE
 Le contexte est figé et ne peut pas être modifié.

Notes

Le contexte par défaut des 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 retourne 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’une cliché instantané, consultez Détails de l’implémentation pour la création de clichés instantanés.

Pour obtenir une discussion complète des contextes de cliché instantané autorisé, consultez _VSS_SNAPSHOT_CONTEXT et _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.

Configuration requise

   
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