Funzione RxpTrackDereference (fcb.h)

Articolo
08/07/2023

RxpTrackDereference viene usato nelle build controllate per tenere traccia delle richieste di dereferenza SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB e SRV_OPEN strutture nelle compilazioni controllate. È possibile accedere a un log di queste richieste di dereferenza dal sistema di registrazione e da 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 dereferenza monitorato. Questo valore può essere una delle macro seguenti definite in fcb.h:

RDBSS_REF_TRACK_SRVCALL

Richiesta di dereferenza in una struttura SRV_CALL.

RDBSS_REF_TRACK_NETROOT

Richiesta di dereferenza in una struttura NET_ROOT.

RDBSS_REF_TRACK_VNETROOT

Richiesta di dereferenza in una struttura V_NET_ROOT.

RDBSS_REF_TRACK_NETFOBX

Richiesta di dereferenza in una struttura FOBX.

RDBSS_REF_TRACK_NETFCB

Richiesta di dereferenza in una struttura FCB.

RDBSS_REF_TRACK_SRVOPEN

Richiesta di dereferenza 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.

Commenti

Nelle build archiviate, RxpTrackDereference viene usato per tenere traccia delle richieste di dereferenza SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB e SRV_OPEN strutture. Per le compilazioni al dettaglio, questa funzione non fa nulla.

Se WMI è abilitato, viene inviato un log delle richieste di dereferenza 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 è abilitata la registrazione.

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

Una serie di macro è definita in fcb.h per il debug che è il modo preferito per chiamare questa routine. Queste macro forniscono un wrapper intorno alle routine RxReference o RxDereference usate per le operazioni di gestione della struttura di file in SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB e SRV_OPEN. Queste macro chiamano prima la routine RxpTrackDereference corrispondente per registrare le informazioni di diagnostica sulla richiesta prima di chiamare la routine RxDereference corrispondente.