Função RxpTrackDereference (fcb.h)
RxpTrackDereference é usado em builds verificados para acompanhar solicitações para desreferenciar estruturas SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB e SRV_OPEN em builds verificados. Um log dessas solicitações de desreferência pode ser acessado pelo sistema de registro em log e pelo WMI.
Sintaxe
BOOLEAN RxpTrackDereference(
[in] ULONG TraceType,
[in] PCSTR FileName,
[in] ULONG Line,
PVOID Instance
);
Parâmetros
[in] TraceType
O valor que determina qual tipo de solicitação de desreferência é rastreado. Esse valor pode ser uma das seguintes macros definidas em fcb.h:
RDBSS_REF_TRACK_SRVCALL
Uma solicitação de desreferência em uma estrutura de SRV_CALL.
RDBSS_REF_TRACK_NETROOT
Uma solicitação de desreferência em uma estrutura de NET_ROOT.
RDBSS_REF_TRACK_VNETROOT
Uma solicitação de desreferência em uma estrutura de V_NET_ROOT.
RDBSS_REF_TRACK_NETFOBX
Uma solicitação de desreferência em uma estrutura FOBX.
RDBSS_REF_TRACK_NETFCB
Uma solicitação de desreferência em uma estrutura FCB.
RDBSS_REF_TRACK_SRVOPEN
Uma solicitação de desreferência em uma estrutura de SRV_OPEN.
[in] FileName
O nome do arquivo de origem em que essa rotina foi chamada.
[in] Line
O número de linha no arquivo de origem em que essa rotina foi chamada.
Instance
Um ponteiro para a estrutura a ser desreferenciada.
Valor de retorno
RxpTrackDereference sempre retorna TRUE em builds verificados.
Observações
Em builds verificados, RxpTrackDereference é usado para acompanhar solicitações para desreferenciar 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 das solicitaçõ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 desreferencia a estrutura passada (decrementar 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 RxpTrackDereference correspondente para registrar informações de diagnóstico sobre a solicitação antes de chamar a rotina de RxDereference correspondente.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | fcb.h (incluir Fcb.h) |
| IRQL | <= APC_LEVEL |