Méthode CVssWriter ::GetContext (vswriter.h)

Article
03/13/2024

Les informations GetContext retournent le contexte actuel pour les clichés instantanés en cours ou possibles.

GetContext est une méthode protégée implémentée par la classe de base CVssWriter .

Syntaxe

LONG GetContext();

Valeur de retour

Cette méthode retourne le contexte de tous les clichés instantanés impliquant l’enregistreur en tant que masque de bits (ou OR au niveau du bit) de valeurs _VSS_SNAPSHOT_CONTEXT et _VSS_VOLUME_SNAPSHOT_ATTRIBUTES .

Remarques

Le contexte par défaut d’un cliché instantané est VSS_CTX_BACKUP.

Un demandeur peut définir le contexte d’un cliché instantané en appelant IVssBackupComponents ::SetContext à tout moment avant de créer un cliché instantané avec IVssBackupComponents ::D oSnapshotSet.

IVssBackupComponents ::D oSnapshotSet génère un certain nombre d’événements (PrepareForSnapshot, Freeze, Thaw, PostSnapshot), dont le premier est PrepareForSnapshot.

Par conséquent, si un writer participe à une opération de cliché instantané, une valeur définitive du contexte de ce cliché instantané est introuvable lorsque GetContext est appelé avant CVssWriter ::OnPrepareSnapshot.

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	vswriter.h (inclure Vss.h, VsWriter.h)
Bibliothèque	VssApi.lib