Funzione CreateTraceInstanceId (evntrace.h)

Un provider di eventi basato su RegisterTraceGuids ("classico") può usare la funzione CreateTraceInstanceId per creare un identificatore di transazione univoco e eseguirne il mapping a un handle di registrazione. Il provider usa quindi l'identificatore della transazione quando si chiama la funzione TraceEventInstance per contrassegnare gli eventi come appartenenti alla transazione specificata. L'identificatore della transazione può essere usato dagli strumenti di analisi di traccia per raggruppare gli eventi.

Sintassi

ULONG WMIAPI CreateTraceInstanceId(
  [in]  HANDLE               RegHandle,
  [out] PEVENT_INSTANCE_INFO InstInfo
);

Parametri

[in] RegHandle

Handle in una classe di traccia eventi registrata. La funzione RegisterTraceGuids restituisce questo handle nel membro RegHandle della struttura TRACE_GUID_REGISTRATION .

[out] InstInfo

Puntatore a una struttura EVENT_INSTANCE_INFO . Il membro InstanceId di questa struttura contiene l'identificatore della transazione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è 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:

  • RegHandle è NULL.
  • pInstInfo è NULL.

Commenti

I provider basati su RegisterTraceGuids ("classico") chiamano questa funzione. Usare EventActivityIdControl per funzionalità simili con un provider EventRegister ("Crimson").

ETW crea l'identificatore nel processo in modalità utente, quindi potrebbe restituire lo stesso numero per istanze diverse in processi diversi. Il valore inizia quando 1InstanceId raggiunge il valore massimo per una ULONG. Solo i provider in modalità utente possono chiamare la funzione CreateTraceInstanceId (i driver non possono chiamare questa funzione).

Esempio

Per un esempio che usa CreateTraceInstanceId, vedere Traccia delle istanze degli eventi.

Requisiti

Vedi anche

RegisterTraceGuids

TraceEventInstance