GetTraceLoggerHandle, fonction (evntrace.h)

  • Article

Un fournisseur d’événements basé sur RegisterTraceGuids (« Classique ») utilise la fonction GetTraceLoggerHandle pour récupérer le handle de la session de suivi d’événements dans laquelle il doit écrire des événements.

Les fournisseurs appellent cette fonction à partir de leur fonction ControlCallback .

Syntaxe

TRACEHANDLE WMIAPI GetTraceLoggerHandle(
  [in] PVOID Buffer
);

Paramètres

[in] Buffer

Pointeur vers une structure WNODE_HEADER . ETW transmet cette structure à la fonction ControlCallback du fournisseur dans le paramètre Buffer .

Le membre HistoricalContext de WNODE_HEADER contient le handle de la session.

Valeur retournée

Si la fonction réussit, elle retourne le handle de session de suivi des événements.

Si la fonction échoue, elle retourne INVALID_HANDLE_VALUE. Pour obtenir des informations détaillées sur l’erreur, appelez la fonction GetLastError.

Notes

Vous utilisez le handle lors de l’appel des fonctions GetTraceEnableFlags et GetTraceEnableLevel pour récupérer les indicateurs d’activation et les valeurs de niveau passés à la fonction EnableTrace .

Exemples

Pour obtenir un exemple qui utilise GetTraceLoggerHandle, consultez Récupération de données d’événement à l’aide de MOF.

Spécifications

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête evntrace.h
Bibliothèque Advapi32.lib
DLL Advapi32.dll

Voir aussi

GetTraceEnableFlags

GetTraceEnableLevel