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