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

Статья
02/06/2025

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

Синтаксис

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

Параметры

TraceType

[in] Значение, определяющее тип ссылочного запроса. Это значение может быть одним из следующих макросов, определенных в 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.

FileName

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

Line

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

Instance

Указатель на структуру, на который нужно ссылаться.

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

Никакой

Замечания

В проверенных сборках RxpTrackReference используется для отслеживания запросов для ссылки на 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. Эти макросы сначала вызывают соответствующую RxpTrackReference подпрограмму для регистрации диагностических сведений о запросе перед вызовом соответствующей процедуры RxReference.

Для розничных сборок эта функция ничего не делает.