RxpTrackDereference-Funktion (fcb.h)

Artikel
02/26/2024

RxpTrackDereference wird in überprüften Builds verwendet, um Anforderungen zur Dereferenzierung SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB und SRV_OPEN Strukturen in überprüften Builds nachzuverfolgen. Auf ein Protokoll dieser Dereferenzierungsanforderungen kann das Protokollierungssystem und WMI zugreifen.

Syntax

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

Parameter

[in] TraceType

Der Wert, der bestimmt, welcher Dereferenzierungsanforderungstyp nachverfolgt wird. Dieser Wert kann eines der folgenden Makros sein, die in fcb.h definiert sind:

RDBSS_REF_TRACK_SRVCALL

Eine Dereferenzierungsanforderung für eine SRV_CALL-Struktur.

RDBSS_REF_TRACK_NETROOT

Eine Dereferenzierungsanforderung für eine NET_ROOT-Struktur.

RDBSS_REF_TRACK_VNETROOT

Eine Dereferenzierungsanforderung für eine V_NET_ROOT-Struktur.

RDBSS_REF_TRACK_NETFOBX

Eine Dereferenzierungsanforderung für eine FOBX-Struktur.

RDBSS_REF_TRACK_NETFCB

Eine Dereferenzierungsanforderung für eine FCB-Struktur.

RDBSS_REF_TRACK_SRVOPEN

Eine Dereferenzierungsanforderung 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 dereferenziert werden soll.

Rückgabewert

RxpTrackDereference gibt bei überprüften Builds immer TRUE zurück.

Hinweise

In überprüften Builds wird RxpTrackDereference verwendet, um Anforderungen zur Dereferenzierung SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB und SRV_OPEN-Strukturen nachzuverfolgen. Bei Einzelhandelsbuilds bewirkt diese Funktion nichts.

Wenn WMI aktiviert ist, wird ein Protokoll der Dereferenzierungsanforderungen als WMI-Ereignis an WMI-Komponenten im Benutzermodus gesendet, die eine Benachrichtigung angefordert haben. Die Deference-Anforderung wird auch im 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 dereferenziert (dekrementieren Sie die Verweisanzahl für die -Struktur).

In fcb.h sind 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 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 zur Anforderung zu protokollieren, bevor die entsprechende RxDereference-Routine aufgerufen wird.