GetTraceLoggerHandle, fonction (evntrace.h)
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 |