Função RxpTrackDereference (fcb.h)

Artigo
02/26/2024

RxpTrackDereference é usado em builds verificados para acompanhar solicitações de desreferência SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB e estruturas de 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.

Retornar valor

RxpTrackDereference sempre retorna TRUE em builds verificados.

Comentários

Em builds verificados, RxpTrackDereference é usado para rastrear 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 do modo de usuário que solicitaram a notificação. A solicitação de deferência também é registrada no sistema de log rdbss chamando a rotina _RxLog para registrar uma entrada de log de erros de E/S se o registro em log estiver habilitado.

Observe que essa rotina não desreferencia a estrutura passada (diminuindo a contagem de referência na estrutura).

Várias macros são definidas em fcb.h para depuração que são a maneira preferencial de chamar essa rotina. Essas macros fornecem um wrapper em torno das rotinas 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 RxpTrackDereference correspondente para registrar informações de diagnóstico sobre a solicitação antes de chamar a rotina de RxDereference correspondente.