Fonction TraceLoggingRegisterEx (traceloggingprovider.h)
Inscrit un fournisseur TraceLogging afin qu’il puisse être utilisé pour journaliser des événements, en spécifiant un rappel d’activation ETW. L’inscription est valide jusqu’à ce que le fournisseur ne soit pas inscrit ou que le processus se termine.
Syntaxe
TLG_STATUS TraceLoggingRegisterEx(
[in, out] TraceLoggingHProvider hProvider,
[in, optional] TLG_PENABLECALLBACK pEnableCallback,
[in, optional] PVOID pCallbackContext
);
Paramètres
[in, out] hProvider
Handle du fournisseur TraceLogging à inscrire. Le handle ne doit pas déjà être inscrit.
[in, optional] pEnableCallback
ETW Activer le rappel qui sera appelé lorsqu’une session de trace active ou désactive votre fournisseur.
[in, optional] pCallbackContext
Pointeur contextuel facultatif défini par le fournisseur à passer au rappel.
Valeur retournée
Si vous appelez cette fonction à partir du code en mode utilisateur, la fonction retourne un HRESULT. Utilisez la SUCCEEDED() macro pour déterminer si la fonction réussit.
Si vous appelez cette fonction à partir de code en mode noyau, la fonction retourne un NTSTATUS. Utilisez la NT_SUCCESS() macro pour déterminer si la fonction réussit.
Notes
Le code d’erreur retourné par TraceLoggingRegisterEx est principalement destiné à être utilisé dans les scénarios de débogage et de diagnostic. La plupart du code de production doit continuer à s’exécuter même si un fournisseur ETW n’a pas pu s’inscrire. Par conséquent, les builds release doivent généralement ignorer le code d’erreur retourné par TraceLoggingRegisterEx.
Remarques
Pour plus d’informations sur l’inscription des fournisseurs , consultez TraceLoggingRegister . Pour plus d’informations sur le comportement du rappel, consultez ETW Enable Callback .
TraceLoggingRegisterEx effectue les opérations suivantes :
- Appelle EventRegister pour ouvrir la connexion à ETW.
- Si EventRegister réussit, appelez TraceLoggingSetInformation avec InformationClassEventProviderSetTraits pour configurer le fournisseur pour la prise en charge de TraceLogging.
Un appel à TraceLoggingRegister est identique à un appel à TraceLoggingRegisterEx avec NULL pour les paramètres de rappel et de contexte . Utilisez TraceLoggingRegisterEx si vous devez recevoir un rappel d’activation ETW lorsque les sessions activent ou désactivent votre fournisseur.
Configuration requise
| Client minimal pris en charge | Windows Vista [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | traceloggingprovider.h |
| Bibliothèque | Advapi32.lib |
| DLL | N/A |