WMIDPREQUEST-Rückruffunktion (evntrace.h)

Artikel
08/23/2023

Ein RegisterTraceGuids-basierter ("Classic")-Ereignisanbieter implementiert diese Funktion, um Benachrichtigungsanforderungen von Controllern zu empfangen oder zu deaktivieren.

Der WMIDPREQUEST-Typ definiert einen Zeiger auf diese Rückruffunktion. ControlCallback ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

WMIDPREQUEST Wmidprequest;

ULONG Wmidprequest(
  [in] WMIDPREQUESTCODE RequestCode,
       PVOID RequestContext,
       ULONG *BufferSize,
  [in] PVOID Buffer
)
{...}

Parameter

[in] RequestCode

Anforderungscode. Dies ist einer der folgenden Werte.

Wert	Bedeutung
WMI_ENABLE_EVENTS	Aktiviert die Anbieter- oder Änderungsanbieterkonfiguration.
WMI_DISABLE_EVENTS	Deaktiviert den Anbieter.

RequestContext

Vom Anbieter definierter Kontext. Der Anbieter verwendet den RequestContext-Parameter von
RegisterTraceGuids , um den Kontext anzugeben.

BufferSize

Für die interne Verwendung reserviert.

[in] Buffer

Zeiger auf eine WNODE_HEADER Struktur, die Informationen zur Ereignisablaufverfolgungssitzung enthält, für die der Anbieter aktiviert oder deaktiviert wird.

Rückgabewert

Sie sollten ERROR_SUCCESS zurückgeben, wenn der Rückruf erfolgreich ist. Beachten Sie, dass ETW den Rückgabewert für diese Funktion ignoriert, außer wenn ein Controller EnableTrace aufruft , um einen Anbieter zu aktivieren, und der Anbieter noch nicht RegisterTraceGuids aufgerufen hat. In diesem Fall gibt RegisterTraceGuids den Rückgabewert dieses Rückrufs zurück, wenn die Registrierung erfolgreich war.

Hinweise

Diese Funktion wird mithilfe der Funktion RegisterTraceGuids angegeben. Wenn der Controller die EnableTrace-Funktion aufruft , um die Aktivierungsflags oder -ebene zu aktivieren, zu deaktivieren oder zu ändern, ruft ETW diesen Rückruf auf. Der Anbieter aktiviert oder deaktiviert sich selbst basierend auf dem RequestCode-Wert . In der Regel verwendet der Anbieter diesen Wert, um ein globales Flag festzulegen, um den aktivierten Status anzugeben.

Der Anbieter definiert seine Interpretation, dass aktiviert oder deaktiviert wird. Wenn ein Anbieter aktiviert ist, generiert er im Allgemeinen Ereignisse, aber obwohl er deaktiviert ist, ist dies nicht der Fall.

ETW übergibt nicht die Aktivierungsflags und die Aktivierungsebene, die der Controller an die EnableTrace-Funktion an diesen Rückruf übergibt. Rufen Sie zum Abrufen dieser Informationen die Funktionen GetTraceEnableFlags bzw . GetTraceEnableLevel auf.

Sie müssen auch das Sitzungshandle in diesem Rückruf für zukünftige Aufrufe abrufen. Um das Sitzungshandle abzurufen, rufen Sie die GetTraceLoggerHandle-Funktion auf.

Ihre Rückruffunktion darf keine Elemente aufrufen, die loadLibrary verursachen können (genauer gesagt, alles, was eine Ladeprogrammsperre erfordert).

Beispiele

Eine Beispielimplementierung einer ControlCallback-Funktion finden Sie unter Schreiben klassischer Ereignisse.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	evntrace.h