RxpTrackDereference, fonction (fcb.h)

Article
08/07/2023

RxpTrackDereference est utilisé dans les builds vérifiées pour suivre les demandes de déréférencement des structures SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB et SRV_OPEN dans les builds vérifiées. Un journal de ces demandes de déréférencement est accessible par le système de journalisation et WMI.

Syntaxe

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

Paramètres

[in] TraceType

Valeur qui détermine le type de demande de déréférencement suivi. Cette valeur peut être l’une des macros suivantes définies dans fcb.h :

RDBSS_REF_TRACK_SRVCALL

Demande de déréférencement sur une structure SRV_CALL.

RDBSS_REF_TRACK_NETROOT

Demande de déréférencement sur une structure NET_ROOT.

RDBSS_REF_TRACK_VNETROOT

Demande de déréférencement sur une structure V_NET_ROOT.

RDBSS_REF_TRACK_NETFOBX

Demande de déréférencement sur une structure FOBX.

RDBSS_REF_TRACK_NETFCB

Demande de déréférencement sur une structure FCB.

RDBSS_REF_TRACK_SRVOPEN

Demande de déréférencement sur une structure SRV_OPEN.

[in] FileName

Nom du fichier source où cette routine a été appelée.

[in] Line

Numéro de ligne dans le fichier source où cette routine a été appelée.

Instance

Pointeur vers la structure à déréférencer.

Valeur retournée

RxpTrackDereference retourne toujours TRUE sur les builds vérifiées.

Remarques

Dans les builds vérifiées, RxpTrackDereference est utilisé pour suivre les demandes de déréférencement des structures SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB et SRV_OPEN. Pour les builds de vente au détail, cette fonction ne fait rien.

Si WMI est activé, un journal des demandes de déréférencement est envoyé en tant qu’événement WMI aux composants WMI en mode utilisateur qui ont demandé une notification. La demande de déférence est également journalisée dans le système de journalisation RDBSS en appelant la routine _RxLog pour enregistrer une entrée de journal des erreurs d’E/S si la journalisation est activée.

Notez que cette routine ne déréférence pas réellement la structure passée (décrémenter le nombre de références sur la structure).

Un certain nombre de macros sont définies dans fcb.h pour le débogage, qui constituent la meilleure façon d’appeler cette routine. Ces macros fournissent un wrapper autour des routines RxReference ou RxDereference utilisées pour les opérations de gestion de structure de fichiers sur les structures SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB et SRV_OPEN. Ces macros appellent d’abord la routine RxpTrackDereference correspondante pour journaliser les informations de diagnostic sur la demande avant d’appeler la routine RxDereference correspondante.