Méthode IVssBackupComponents::SetContext (vsbackup.h)

  • Article

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
S_OK
 Définissez correctement le contexte.
E_INVALIDARG
 L’une des valeurs de paramètre n’est pas valide.
VSS_E_BAD_STATE
 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.
VSS_E_UNEXPECTED
 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

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::StartSnapshotSet

_VSS_SNAPSHOT_CONTEXT

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES