Função RxpTrackReference (fcb.h)
RxpTrackReference rastreia solicitações para referenciar estruturas SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB e SRV_OPEN em builds verificados. Um log dessas solicitações de referência pode ser acessado pelo sistema de registro em log e pelo WMI.
Sintaxe
void RxpTrackReference(
ULONG TraceType,
PCSTR FileName,
ULONG Line,
PVOID Instance
);
Parâmetros
TraceType
[in] O valor que determina qual tipo de solicitação de referência é rastreado. Esse valor pode ser uma das seguintes macros definidas em fcb.h:
| Valor | Significado |
|---|---|
| RDBSS_REF_TRACK_SRVCALL | Uma solicitação de referência em uma estrutura SRV_CALL. |
| RDBSS_REF_TRACK_NETROOT | Uma solicitação de referência em uma estrutura NET_ROOT. |
| RDBSS_REF_TRACK_VNETROOT | Uma solicitação de referência em uma estrutura de V_NET_ROOT. |
| RDBSS_REF_TRACK_NETFOBX | Uma solicitação de referência em uma estrutura FOBX. |
| RDBSS_REF_TRACK_NETFCB | Uma solicitação de referência em uma estrutura FCB. |
| RDBSS_REF_TRACK_SRVOPEN | Uma solicitação de referência em uma estrutura SRV_OPEN. |
FileName
[in] O nome do arquivo de origem em que essa rotina foi chamada.
Line
[in] O número de linha no arquivo de origem em que essa rotina foi chamada.
Instance
Um ponteiro para a estrutura a ser referenciada.
Valor de retorno
Nenhum
Observações
Em builds verificados, RxpTrackReference é usado para acompanhar solicitações para fazer referência a estruturas SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB e SRV_OPEN. Para builds de varejo, essa função não faz nada.
Se o WMI estiver habilitado, um log dessas operações de desreferência será enviado como um evento WMI para componentes WMI no modo de usuário que solicitaram a notificação. A solicitação de deferência também é registrada no sistema de log do RDBSS chamando a rotina de _RxLog para registrar uma entrada de log de erros de E/S se o registro em log estiver habilitado.
Observe que essa rotina realmente não faz referência à estrutura passada (incremente a contagem de referência na estrutura).
Várias macros são definidas em fcb.h para depuração que são a maneira preferida de chamar essa rotina. Essas macros fornecem um wrapper em torno das rotinas de RxReference ou RxDereference usadas para operações de gerenciamento de estrutura de arquivos em estruturas SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB e SRV_OPEN. Essas macros primeiro chamam a rotina de RxpTrackReference correspondente para registrar informações de diagnóstico sobre a solicitação antes de chamar a rotina de RxReference correspondente.
Para builds de varejo, essa função não faz nada.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | fcb.h (incluir Fcb.h) |
| IRQL | <= APC_LEVEL |