RxpTrackReference-Funktion (fcb.h)

Artikel
03/01/2024

RxpTrackReference verfolgt Anforderungen zum Verweisen auf SRV_CALL-, NET_ROOT-, V_NET_ROOT-, FOBX-, FCB- und SRV_OPEN-Strukturen in überprüften Builds nach. Auf ein Protokoll dieser Verweisanforderungen kann vom 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.h definiert 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

Keine

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. Für Einzelhandelsbuilds macht diese Funktion nichts.

Wenn WMI aktiviert ist, wird ein Protokoll dieser Rückschlussvorgänge als WMI-Ereignis an WMI-Komponenten im Benutzermodus gesendet, die eine Benachrichtigung angefordert haben. Die Zurückstellungsanforderung 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 Verweisanzahl für die Struktur).

In fcb.h werden eine Reihe von Makros 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 auf 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 die entsprechende RxReference-Routine aufgerufen wird.

Für Einzelhandelsbuilds macht diese Funktion nichts.