Función RxpTrackDereference (fcb.h)

Artículo
03/05/2024

RxpTrackDereference se usa en compilaciones activadas para realizar un seguimiento de las solicitudes de desreferencia SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB y estructuras de SRV_OPEN en compilaciones comprobadas. El sistema de registro y WMI pueden acceder a un registro de estas solicitudes de desreferencia.

Sintaxis

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

Parámetros

[in] TraceType

Valor que determina qué tipo de solicitud de desreferencia se realiza un seguimiento. Este valor puede ser una de las siguientes macros definidas en fcb.h:

RDBSS_REF_TRACK_SRVCALL

Solicitud de desreferencia en una estructura de SRV_CALL.

RDBSS_REF_TRACK_NETROOT

Solicitud de desreferencia en una estructura de NET_ROOT.

RDBSS_REF_TRACK_VNETROOT

Solicitud de desreferencia en una estructura de V_NET_ROOT.

RDBSS_REF_TRACK_NETFOBX

Solicitud de desreferencia en una estructura FOBX.

RDBSS_REF_TRACK_NETFCB

Una solicitud de desreferencia en una estructura FCB.

RDBSS_REF_TRACK_SRVOPEN

Solicitud de desreferencia en una estructura de SRV_OPEN.

[in] FileName

Nombre del archivo de origen donde se llamó a esta rutina.

[in] Line

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

Instance

Puntero a la estructura que se va a desreferenciar.

Valor devuelto

RxpTrackDereference siempre devuelve TRUE en las compilaciones activadas.

Comentarios

En las compilaciones comprobadas, RxpTrackDereference se usa para realizar un seguimiento de las solicitudes de desreferencia SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB y estructuras de 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 las solicitudes 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 de RDBSS llamando 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 desreferencia realmente la estructura pasada (disminuye el recuento de referencias en la estructura).

Una serie de 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 en torno a las rutinas RxReference o RxDereference 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 RxpTrackDereference correspondiente para registrar información de diagnóstico sobre la solicitud antes de llamar a la rutina RxDereference correspondiente.