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

Статья
02/06/2025

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.