Función RxpTrackReference (fcb.h)

Artículo
02/06/2025

RxpTrackReference realiza un seguimiento de las solicitudes para hacer referencia a estructuras SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB y SRV_OPEN en compilaciones comprobadas. El sistema de registro y WMI pueden acceder a un registro de estas solicitudes de referencia.

Sintaxis

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

Parámetros

TraceType

[in] Valor que determina el tipo de solicitud de referencia al que se realiza el seguimiento. Este valor puede ser una de las siguientes macros definidas en fcb.h:

Valor	Significado
RDBSS_REF_TRACK_SRVCALL	Una solicitud de referencia en una estructura de SRV_CALL.
RDBSS_REF_TRACK_NETROOT	Solicitud de referencia en una estructura de NET_ROOT.
RDBSS_REF_TRACK_VNETROOT	Solicitud de referencia en una estructura de V_NET_ROOT.
RDBSS_REF_TRACK_NETFOBX	Solicitud de referencia en una estructura FOBX.
RDBSS_REF_TRACK_NETFCB	Solicitud de referencia en una estructura FCB.
RDBSS_REF_TRACK_SRVOPEN	Solicitud de referencia en una estructura de SRV_OPEN.

FileName

[in] Nombre del archivo de origen al que se llamó a esta rutina.

Line

[in] Número de línea del archivo de origen al que se llamó a esta rutina.

Instance

Puntero a la estructura a la que se va a hacer referencia.

Valor devuelto

Ninguno

Observaciones

En las compilaciones comprobadas, rxpTrackReference se usa para realizar un seguimiento de las solicitudes para hacer referencia a estructuras SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB y SRV_OPEN. En el caso de las compilaciones comerciales, esta función no hace nada.

Si WMI está habilitado, se envía un registro de estas operaciones de desreferencia como un evento WMI a los componentes WMI en modo de usuario que han solicitado la notificación. La solicitud de deferencia también se registra en el sistema de registro RDBSS llamando a la rutina de _RxLog para registrar una entrada de registro de errores de E/S si el registro está habilitado.

Tenga en cuenta que esta rutina no hace referencia realmente a la estructura pasada (incremente el recuento de referencias en la estructura).

Varias macros se definen en fcb.h para la depuración que es la manera preferida de llamar a esta rutina. Estas macros proporcionan un contenedor alrededor de las rxReference o RxDereference rutinas usadas para las operaciones de administración de estructuras de archivos en SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB y estructuras de SRV_OPEN. Estas macros llaman primero a la rutina de RxpTrackRefer ence correspondiente para registrar información de diagnóstico sobre la solicitud antes de llamar a la rutina de de RxReference correspondiente.

En el caso de las compilaciones comerciales, esta función no hace nada.