Méthode CVssWriterEx2 ::GetSessionId (vswriter.h)

  • Article

Retourne l’identificateur de session de l’enregistreur.

Syntaxe

HRESULT GetSessionId(
  [out] VSS_ID *idSession
);

Paramètres

[out] idSession

Pointeur vers une variable qui reçoit l’identificateur de session.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

L’identificateur de session est une valeur opaque qui identifie de manière unique une session de sauvegarde ou de restauration. Il est utilisé pour distinguer la session active entre plusieurs sessions de sauvegarde ou de restauration parallèles.

En guise de meilleure pratique, les rédacteurs et les demandeurs doivent inclure l’ID de session dans tous les messages diagnostics utilisés pour la journalisation et le suivi des événements.

Si le gestionnaire d’événements d’un writer (tel que CVssWriter ::OnFreeze) appelle cette méthode, il doit le faire dans le même thread que celui qui a appelé le gestionnaire d’événements. Pour plus d’informations, consultez Gestion des événements writer.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête vswriter.h (inclure Vss.h, VsWriter.h)
Bibliothèque VssApi.lib

Voir aussi

CVssWriterEx2

IVssBackupComponentsEx3 ::GetSessionId