Funzione TraceLoggingRegisterEx (traceloggingprovider.h)

Articolo
08/26/2023

Registra un provider TraceLogging in modo che possa essere usato per registrare gli eventi, specificando un callback di abilitazione ETW. La registrazione è valida fino a quando il provider non viene registrato o il processo viene chiuso.

Sintassi

TLG_STATUS TraceLoggingRegisterEx(
  [in, out]      TraceLoggingHProvider hProvider,
  [in, optional] TLG_PENABLECALLBACK   pEnableCallback,
  [in, optional] PVOID                 pCallbackContext
);

Parametri

[in, out] hProvider

Handle del provider TraceLogging da registrare. L'handle non deve essere già registrato.

[in, optional] pEnableCallback

Abilita callback ETW che verrà richiamato quando una sessione di traccia abilita o disabilita il provider.

[in, optional] pCallbackContext

Puntatore di contesto definito dal provider facoltativo da passare al callback.

Valore restituito

Se si chiama questa funzione dal codice in modalità utente, la funzione restituisce un oggetto HRESULT. Utilizzare la SUCCEEDED() macro per determinare se la funzione ha esito positivo.

Se si chiama questa funzione dal codice in modalità kernel, la funzione restituisce un oggetto NTSTATUS. Utilizzare la NT_SUCCESS() macro per determinare se la funzione ha esito positivo.

Nota

Il codice di errore restituito da TraceLoggingRegisterEx è destinato principalmente all'uso negli scenari di debug e diagnostica. La maggior parte del codice di produzione deve continuare a essere eseguita anche se non è stato possibile registrare un provider ETW, pertanto le build di versione devono in genere ignorare il codice di errore restituito da TraceLoggingRegisterEx.

Commenti

Per informazioni dettagliate sulla registrazione dei provider, vedere TraceLoggingRegister . Per informazioni dettagliate sul comportamento di callback, vedere ETW Enable Callback (Abilita callback ETW ).

TraceLoggingRegisterEx esegue le operazioni seguenti:

Chiama EventRegister per aprire la connessione a ETW.
Se EventRegister ha esito positivo, chiama TraceLoggingSetInformation con InformationClassEventProviderSetTraits per configurare il provider per il supporto traceLogging.

Una chiamata a TraceLoggingRegister equivale a una chiamata a TraceLoggingRegisterEx con NULL per i parametri di callback e contesto . Usare TraceLoggingRegisterEx se è necessario ricevere un callback di abilitazione ETW quando le sessioni abilitano o disabilitano il provider.

Requisiti


Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	traceloggingprovider.h
Libreria	Advapi32.lib
DLL	N/D