Función RxpTrackReference (fcb.h)

Artículo
02/29/2024

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 un seguimiento. Este valor puede ser una de las macros siguientes definidas en fcb.h:

Valor	Significado
RDBSS_REF_TRACK_SRVCALL	Una solicitud de referencia en una estructura de SRV_CALL.
RDBSS_REF_TRACK_NETROOT	Una solicitud de referencia en una estructura de NET_ROOT.
RDBSS_REF_TRACK_VNETROOT	Una 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 SRV_OPEN.

FileName

[in] Nombre del archivo de origen donde 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

None

Observaciones

En las compilaciones comprobadas, RxpTrackReference se usa para realizar un seguimiento de las solicitudes para hacer referencia a estructuras de 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 desreferenciación 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 mediante una llamada a la rutina _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 rutinas RxReference o RxDereference que se usan para las operaciones de administración de estructuras de archivos en SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB y estructuras SRV_OPEN. Estas macros llaman primero a la rutina RxpTrackReference correspondiente para registrar información de diagnóstico sobre la solicitud antes de llamar a la rutina RxReference correspondiente.

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