Fonction RxpTrackReference (fcb.h)

Article
02/26/2024

RxpTrackReference suit les requêtes pour référencer les 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 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 SRV_CALL.
RDBSS_REF_TRACK_NETROOT	Demande de référence sur une structure NET_ROOT.
RDBSS_REF_TRACK_VNETROOT	Demande de référence sur une structure de V_NET_ROOT.
RDBSS_REF_TRACK_NETFOBX	Demande 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 SRV_OPEN.

FileName

[in] Nom du fichier source dans lequel 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

None

Remarques

Dans les builds vérifiées, RxpTrackReference est utilisé pour suivre les demandes 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é 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 fait pas référence à la structure passée (incré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 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 la 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 RxpTrackReference correspondante pour consigner 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.