RxpTrackDereference-Funktion (fcb.h)

Artikel
02/06/2025

RxpTrackDereference- wird in überprüften Builds verwendet, um Anforderungen zur Ableitung SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB und SRV_OPEN Strukturen in überprüften Builds nachzuverfolgen. Auf ein Protokoll dieser Ableitungsanforderungen kann über das Protokollierungssystem und WMI zugegriffen werden.

Syntax

BOOLEAN RxpTrackDereference(
  [in] ULONG TraceType,
  [in] PCSTR FileName,
  [in] ULONG Line,
       PVOID Instance
);

Parameter

[in] TraceType

Der Wert, der bestimmt, welcher Dereference-Anforderungstyp nachverfolgt wird. Dieser Wert kann eines der folgenden Makros sein, die in fcb.hdefiniert sind:

RDBSS_REF_TRACK_SRVCALL

Eine Ableitungsanforderung für eine SRV_CALL Struktur.

RDBSS_REF_TRACK_NETROOT

Eine Ableitungsanforderung für eine NET_ROOT Struktur.

RDBSS_REF_TRACK_VNETROOT

Eine Ableitungsanforderung für eine V_NET_ROOT Struktur.

RDBSS_REF_TRACK_NETFOBX

Eine Ableitungsanforderung für eine FOBX-Struktur.

RDBSS_REF_TRACK_NETFCB

Eine Ableitungsanforderung für eine FCB-Struktur.

RDBSS_REF_TRACK_SRVOPEN

Eine Ableitungsanforderung für eine SRV_OPEN Struktur.

[in] FileName

Der Name der Quelldatei, in der diese Routine aufgerufen wurde.

[in] Line

Die Zeilennummer in der Quelldatei, in der diese Routine aufgerufen wurde.

Instance

Ein Zeiger auf die Struktur, die abgeleitet werden soll.

Rückgabewert

RxpTrackDereference- gibt immer TRUE- für überprüfte Builds zurück.

Bemerkungen

In überprüften Builds wird RxpTrackDereference- verwendet, um Anforderungen zur Ableitung SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB und SRV_OPEN Strukturen nachzuverfolgen. Bei Verkaufsbuilds führt diese Funktion nichts aus.

Wenn WMI aktiviert ist, wird ein Protokoll der Ableitungsanforderungen als WMI-Ereignis an WMI-Komponenten im Benutzermodus gesendet, die eine Benachrichtigung angefordert haben. Die Verzögerungsanforderung wird auch beim RDBSS-Protokollierungssystem protokolliert, indem die _RxLog Routine aufgerufen wird, um einen E/A-Fehlerprotokolleintrag aufzuzeichnen, wenn die Protokollierung aktiviert ist.

Beachten Sie, dass diese Routine die übergebene Struktur nicht ableiten kann (erhöhen Sie die Referenzanzahl für die Struktur).

Eine Reihe von Makros werden in fcb.h für das Debuggen definiert, die die bevorzugte Methode zum Aufrufen dieser Routine sind. Diese Makros stellen einen Wrapper um die RxReference- oder RxDereference- Routinen bereit, die für Dateistrukturverwaltungsvorgänge für SRV_CALL-, NET_ROOT-, V_NET_ROOT-, FOBX-, FCB- und SRV_OPEN-Strukturen verwendet werden. Diese Makros rufen zuerst die entsprechende RxpTrackDereference Routine auf, um Diagnoseinformationen über die Anforderung zu protokollieren, bevor sie die entsprechende RxDereference Routine aufrufen.