Funzione RxpTrackDereference (fcb.h)

Articolo
02/06/2025

RxpTrackDereference viene usato nelle compilazioni controllate per tenere traccia delle richieste di dereferenziazione SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB e SRV_OPEN strutture archiviate. È possibile accedere a un log di queste richieste di dereferenziazione tramite il sistema di registrazione e WMI.

Sintassi

BOOLEAN RxpTrackDereference(
  [in] ULONG TraceType,
  [in] PCSTR FileName,
  [in] ULONG Line,
       PVOID Instance
);

Parametri

[in] TraceType

Valore che determina il tipo di richiesta di dereferenziazione rilevato. Questo valore può essere una delle macro seguenti definite in fcb.h:

RDBSS_REF_TRACK_SRVCALL

Richiesta di dereferenziazione in una struttura SRV_CALL.

RDBSS_REF_TRACK_NETROOT

Richiesta di dereferenziazione in una struttura NET_ROOT.

RDBSS_REF_TRACK_VNETROOT

Richiesta di dereferenziazione in una struttura V_NET_ROOT.

RDBSS_REF_TRACK_NETFOBX

Richiesta di dereferenziazione in una struttura FOBX.

RDBSS_REF_TRACK_NETFCB

Richiesta di dereferenziazione in una struttura FCB.

RDBSS_REF_TRACK_SRVOPEN

Richiesta di dereferenziazione in una struttura SRV_OPEN.

[in] FileName

Nome del file di origine in cui è stata chiamata questa routine.

[in] Line

Numero di riga nel file di origine in cui è stata chiamata questa routine.

Instance

Puntatore alla struttura da dereferenziare.

Valore restituito

RxpTrackDereference restituisce sempre true nelle build controllate.

Osservazioni

Nelle compilazioni controllate, RxpTrackDereference viene usato per tenere traccia delle richieste di dereferenziazione SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB e SRV_OPEN strutture. Per le build di vendita al dettaglio, questa funzione non esegue alcuna operazione.

Se WMI è abilitato, un log delle richieste di dereferenziazione viene inviato come evento WMI ai componenti WMI in modalità utente che hanno richiesto la notifica. La richiesta di rinvio viene registrata anche nel sistema di registrazione RDBSS chiamando la routine _RxLog per registrare una voce del log degli errori di I/O se la registrazione è abilitata.

Si noti che questa routine non dereferenzia effettivamente la struttura passata (decrementare il conteggio dei riferimenti sulla struttura).

Alcune macro sono definite in fcb.h per il debug che rappresentano il modo preferito per chiamare questa routine. Queste macro forniscono un wrapper intorno al RxReference o RxDereference routine utilizzate per le operazioni di gestione della struttura di file su SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB e SRV_OPEN strutture. Queste macro chiamano prima il RxpTrackDereference corrispondente routine per registrare le informazioni di diagnostica sulla richiesta prima di chiamare la routine RxDereference corrispondente .