RxpTrackReference-Funktion (fcb.h)

Artikel
02/06/2025

RxpTrackReference- verfolgt Anforderungen zum Verweisen auf SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB und SRV_OPEN Strukturen in überprüften Builds. Auf ein Protokoll dieser Referenzanforderungen kann über das Protokollierungssystem und WMI zugegriffen werden.

Syntax

void RxpTrackReference(
  ULONG TraceType,
  PCSTR FileName,
  ULONG Line,
  PVOID Instance
);

Parameter

TraceType

[in] Der Wert, der bestimmt, welcher Verweisanforderungstyp nachverfolgt wird. Dieser Wert kann eines der folgenden Makros sein, die in fcb.hdefiniert sind:

Wert	Bedeutung
RDBSS_REF_TRACK_SRVCALL	Eine Referenzanforderung für eine SRV_CALL Struktur.
RDBSS_REF_TRACK_NETROOT	Eine Referenzanforderung für eine NET_ROOT Struktur.
RDBSS_REF_TRACK_VNETROOT	Eine Referenzanforderung für eine V_NET_ROOT Struktur.
RDBSS_REF_TRACK_NETFOBX	Eine Referenzanforderung für eine FOBX-Struktur.
RDBSS_REF_TRACK_NETFCB	Eine Referenzanforderung für eine FCB-Struktur.
RDBSS_REF_TRACK_SRVOPEN	Eine Referenzanforderung für eine SRV_OPEN Struktur.

FileName

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

Line

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

Instance

Ein Zeiger auf die Struktur, auf die verwiesen werden soll.

Rückgabewert

Nichts

Bemerkungen

In überprüften Builds wird RxpTrackReference- verwendet, um Anforderungen zum Verweisen auf 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 dieser Ableitungsvorgänge 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 nicht tatsächlich auf die übergebene Struktur verweist (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 RxpTrackReference Routine auf, um Diagnoseinformationen zur Anforderung zu protokollieren, bevor sie die entsprechende RxReference- Routine aufrufen.

Bei Verkaufsbuilds führt diese Funktion nichts aus.