Funzione RegisterTraceGuidsW (evntrace.h)

La funzione RegisterTraceGuids registra un provider di traccia eventi ETW classico (di tipo Windows 2000) e le classi di traccia evento usate per generare eventi. Questa funzione specifica anche la funzione di callback utilizzata dal sistema per abilitare e disabilitare la traccia dal provider.

questa funzione è obsoleta. Il nuovo codice deve usare EventRegister per registrare un provider di traccia eventi ETW (Crimson) di windows Vista .

Sintassi

ULONG WMIAPI RegisterTraceGuidsW(
  [in]      WMIDPREQUEST             RequestAddress,
  [in]      PVOID                    RequestContext,
  [in]      LPCGUID                  ControlGuid,
  [in]      ULONG                    GuidCount,
  [in, out] PTRACE_GUID_REGISTRATION TraceGuidReg,
  [in]      LPCWSTR                  MofImagePath,
  [in]      LPCWSTR                  MofResourceName,
  [out]     PTRACEHANDLE             RegistrationHandle
);

Parametri

[in] RequestAddress

Puntatore a una funzione ControlCallback che riceve una notifica quando il provider è abilitato o disabilitato da una sessione di traccia eventi. La funzione EnableTrace attiva questo callback.

[in] RequestContext

Puntatore a un contesto facoltativo definito dal provider che ETW passa alla funzione specificata da RequestAddress.

[in] ControlGuid

Controllare il GUID (ID provider) del provider di registrazione.

[in] GuidCount

Numero di elementi nella matrice TraceGuidReg . Se TraceGuidReg è NULL, impostare questo parametro su 0.

[in, out] TraceGuidReg

Puntatore a una matrice di
TRACE_GUID_REGISTRATION strutture.

Ogni elemento identifica una categoria di eventi forniti dal provider.

All'input, il membro Guid di ogni struttura contiene un GUID della classe di traccia eventi assegnato dal provider di registrazione. Il GUID della classe identifica una categoria di eventi forniti dal provider. I provider usano lo stesso GUID di classe per impostare il membro Guid di EVENT_TRACE_HEADER quando si chiama la funzione TraceEvent per registrare l'evento.

Nell'output, il membro RegHandle riceve un handle per la registrazione GUID della classe dell'evento. Se il provider chiama la funzione TraceEventInstance , utilizzare il membro RegHandle di TRACE_GUID_REGISTRATION per impostare il membro RegHandle di EVENT_INSTANCE_HEADER.

Questo parametro può essere NULL se il provider chiama solo la funzione TraceEvent per registrare gli eventi. Se il provider chiama la funzione TraceEventInstance per registrare gli eventi, questo parametro non può essere NULL.

[in] MofImagePath

Questo parametro non è supportato. Impostare su NULL. È consigliabile usare Mofcomp.exe per registrare la risorsa MOF durante la configurazione dell'applicazione. Per altre informazioni, vedere Pubblicazione dello schema eventi.

Windows XP con SP1, Windows XP e Windows 2000: Puntatore a una stringa facoltativa che specifica il percorso del programma DLL o eseguibile che contiene la risorsa specificata da MofResourceName. Questo parametro può essere NULL se il provider di eventi e il consumer usano un altro meccanismo per condividere informazioni sulle classi di traccia evento utilizzate dal provider.

[in] MofResourceName

Questo parametro non è supportato. Impostare su NULL. È consigliabile usare Mofcomp.exe per registrare la risorsa MOF durante la configurazione dell'applicazione. Per altre informazioni, vedere Pubblicazione dello schema eventi.

Windows XP con SP1, Windows XP e Windows 2000: Puntatore a una stringa facoltativa che specifica la risorsa stringa di MofImagePath. La risorsa stringa contiene il nome del file MOF binario che descrive le classi di traccia evento supportate dal provider.

[out] RegistrationHandle

Riceve l'handle di registrazione del provider. Usare l'handle restituito quando si chiama la funzione UnregisterTraceGuids .

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore di sistema. Di seguito sono riportati alcuni errori comuni e le relative cause.

• ERROR_INVALID_PARAMETER

  Una delle seguenti condizioni è vera:

  • RequestAddress è NULL.
  • ControlGuid è NULL.
  • RegistrationHandle è NULL.

  Windows XP e Windows 2000:TraceGuidReg è NULL o GuidCount è minore o uguale a zero.

Commenti

Questa funzione apre un handle di provider di eventi classico (windows 2000) che può essere usato per scrivere eventi ETW basati su MOF e TMF tramite TraceEvent, TraceEventInstance, TraceMessage e TraceMessageVa.

Se ControlGuid del provider è stato registrato e abilitato in precedenza, le registrazioni successive che fanno riferimento allo stesso ControlGuid vengono abilitate automaticamente.

Un processo può registrare fino a 1.024 GUID del provider; Tuttavia, è necessario limitare il numero di provider registrati dal processo a uno o due. Questo limite include quelli registrati usando questa funzione e la funzione EventRegister .

Prima di Windows Vista: Non esiste alcun limite al numero di provider che un processo può registrare.

Esempio

Per un esempio che usa RegisterTraceGuids, vedere Scrittura di eventi classici.

Requisiti

Vedi anche

EnableTrace

UnregisterTraceGuids