RxpTrackReference, fonction (fcb.h)

Article
02/06/2025

RxpTrackReference effectue le suivi des requêtes de référence SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB et SRV_OPEN structures dans les builds vérifiées. Un journal de ces demandes de référence est accessible par le système de journalisation et WMI.

Syntaxe

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

Paramètres

TraceType

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

Valeur	Signification
RDBSS_REF_TRACK_SRVCALL	Demande de référence sur une structure de SRV_CALL.
RDBSS_REF_TRACK_NETROOT	Demande de référence sur une structure de NET_ROOT.
RDBSS_REF_TRACK_VNETROOT	Demande de référence sur une structure de V_NET_ROOT.
RDBSS_REF_TRACK_NETFOBX	Requête de référence sur une structure FOBX.
RDBSS_REF_TRACK_NETFCB	Demande de référence sur une structure FCB.
RDBSS_REF_TRACK_SRVOPEN	Demande de référence sur une structure de SRV_OPEN.

FileName

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

Line

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

Instance

Pointeur vers la structure à référencer.

Valeur de retour

Aucun

Remarques

Dans les builds vérifiées, RxpTrackReference est utilisée pour suivre les requêtes de référence SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB et SRV_OPEN structures. Pour les builds de vente au détail, cette fonction ne fait rien.

Si WMI est activé, un journal de ces opérations de déréférencement est envoyé en tant qu’événement WMI aux composants WMI en mode utilisateur qui ont demandé la notification. La demande de inférence est également enregistré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 référence pas réellement la structure passée (incrémentez 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 sont le moyen préféré 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 SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB et SRV_OPEN structures. Ces macros appellent d’abord la routine RxpTrackReference correspondante pour journaliser les informations de diagnostic sur la demande avant d’appeler la routine RxReference correspondante.

Pour les builds de vente au détail, cette fonction ne fait rien.