Função RxpTrackReference (fcb.h)

Artigo
02/26/2024

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 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.

Retornar valor

Nenhum

Comentários

Em builds verificados, RxpTrackReference é usado para acompanhar solicitações para referenciar 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 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 faz referência realmente à 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 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 estruturas. Essas macros primeiro chamam a rotina RxpTrackReference correspondente para registrar informações de diagnóstico sobre a solicitação antes de chamar a rotina RxReference correspondente.

Para builds de varejo, essa função não faz nada.