Функция 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 |