Функция RxpTrackReference (fcb.h)
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
Указатель на структуру, на которая должна ссылаться.
Возвращаемое значение
None
Remarks
В проверенных сборках 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 .
Для розничных сборок эта функция не выполняет никаких действий.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | fcb.h (включая Fcb.h) |
| IRQL | <= APC_LEVEL |