CreateTraceInstanceId-Funktion (evntrace.h)

Ein RegisterTraceGuids-basierter Ereignisanbieter ("Classic") kann die CreateTraceInstanceId-Funktion verwenden, um einen eindeutigen Transaktionsbezeichner zu erstellen und ihn einem Registrierungshandle zuzuordnen. Der Anbieter verwendet dann den Transaktionsbezeichner beim Aufrufen der TraceEventInstance-Funktion , um Ereignisse als zur angegebenen Transaktion gehören zu markieren. Der Transaktionsbezeichner kann von Ablaufverfolgungsanalysetools verwendet werden, um Ereignisse zu gruppieren.

Syntax

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

Parameter

[in] RegHandle

Behandeln sie eine registrierte Ereignisablaufverfolgungsklasse. Die Funktion RegisterTraceGuids gibt dieses Handle im RegHandle-Member der TRACE_GUID_REGISTRATION-Struktur zurück.

[out] InstInfo

Zeiger auf eine EVENT_INSTANCE_INFO-Struktur . Das InstanceId-Element dieser Struktur enthält den Transaktionsbezeichner.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der Systemfehlercodes. Im Folgenden sind einige häufige Fehler und deren Ursachen aufgeführt.

• ERROR_INVALID_PARAMETER

  Es trifft eine der folgenden Bedingungen zu:

  • RegHandle ist NULL.
  • pInstInfo ist NULL.

Hinweise

RegisterTraceGuids-basierte Anbieter ("Classic") rufen diese Funktion auf. Verwenden Sie EventActivityIdControl für ähnliche Funktionen mit einem EventRegister-basierten Anbieter ("Crimson").

ETW erstellt den Bezeichner im Benutzermodusprozess, sodass er möglicherweise dieselbe Anzahl für verschiedene Instanzen in verschiedenen Prozessen zurückgibt. Der Wert beginnt von vorn, 1 wenn InstanceId den Maximalwert für eine ULONG erreicht. Nur Benutzermodusanbieter können die CreateTraceInstanceId-Funktion aufrufen (Treiber können diese Funktion nicht aufrufen).

Beispiele

Ein Beispiel, das CreateTraceInstanceId verwendet, finden Sie unter Ablaufverfolgungsereignisinstanzen.

Anforderungen

Weitere Informationen

RegisterTraceGuids

TraceEventInstance