Функция RxpTrackDereference (fcb.h)

RxpTrackDereference используется в проверенных сборках для отслеживания запросов на разыменовывание SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB и SRV_OPEN структур в проверенных сборках. К журналу этих запросов на разыменовывание может обращаться система ведения журнала и WMI.

Синтаксис

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

Параметры

[in] TraceType

Значение, определяющее, какой тип запроса разыменования отслеживается. Это значение может быть одним из следующих макросов, определенных в fcb.h:

RDBSS_REF_TRACK_SRVCALL

Запрос разыменования в структуре SRV_CALL.

RDBSS_REF_TRACK_NETROOT

Запрос разыменования в структуре NET_ROOT.

RDBSS_REF_TRACK_VNETROOT

Запрос разыменования в V_NET_ROOT структуре.

RDBSS_REF_TRACK_NETFOBX

Запрос разыменования в структуре FOBX.

RDBSS_REF_TRACK_NETFCB

Запрос на разыменовку в структуре FCB.

RDBSS_REF_TRACK_SRVOPEN

Запрос разыменования в структуре SRV_OPEN.

[in] FileName

Имя исходного файла, в котором была вызвана эта подпрограмма.

[in] Line

Номер строки в исходном файле, в котором была вызвана эта подпрограмма.

Instance

Указатель на разыменовываемую структуру.

Возвращаемое значение

RxpTrackDereference всегда возвращает значение TRUE для проверенных сборок.

Комментарии

В проверенных сборках RxpTrackDereference используется для отслеживания запросов на разыменовывание SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB и SRV_OPEN структур. Для розничных сборок эта функция ничего не делает.

Если WMI включен, журнал запросов на разыменовывание отправляется в качестве события WMI компонентам WMI пользовательского режима, которые запросили уведомление. Запрос на уважение также регистрируется в системе ведения журнала RDBSS путем вызова подпрограммы _RxLog для записи записи записи журнала ошибок ввода-вывода, если ведение журнала включено.

Обратите внимание, что эта подпрограмма фактически не разыменовывает переданную структуру (уменьшение количества ссылок в структуре).

В fcb.h определен ряд макросов для отладки, которые являются предпочтительным способом вызова этой подпрограммы. Эти макросы предоставляют оболочку для подпрограмм RxReference или RxDereference , используемых для операций управления структурой файлов в SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB и SRV_OPEN структурах. Эти макросы сначала вызывают соответствующую подпрограмму RxpTrackDereference для регистрации диагностических сведений о запросе, прежде чем вызывать соответствующую подпрограмму RxDereference .

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть fcb.h (включая Fcb.h)
IRQL <= APC_LEVEL

См. также раздел

RxAssert

RxDbgBreakPoint

RxDereference

RxReference

RxpTrackReference

_RxLog