Funzione RxpTrackReference (fcb.h)

Articolo
02/26/2024

RxpTrackReference tiene traccia delle richieste per fare riferimento a 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 riferimento tramite il sistema di registrazione e WMI.

Sintassi

void RxpTrackReference(
  ULONG TraceType,
  PCSTR FileName,
  ULONG Line,
  PVOID Instance
);

Parametri

TraceType

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

Valore	Significato
RDBSS_REF_TRACK_SRVCALL	Richiesta di riferimento in una struttura di SRV_CALL.
RDBSS_REF_TRACK_NETROOT	Richiesta di riferimento in una struttura di NET_ROOT.
RDBSS_REF_TRACK_VNETROOT	Richiesta di riferimento in una struttura di V_NET_ROOT.
RDBSS_REF_TRACK_NETFOBX	Richiesta di riferimento in una struttura FOBX.
RDBSS_REF_TRACK_NETFCB	Richiesta di riferimento in una struttura FCB.
RDBSS_REF_TRACK_SRVOPEN	Richiesta di riferimento in una struttura di SRV_OPEN.

FileName

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

Line

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

Instance

Puntatore alla struttura a cui fare riferimento.

Valore restituito

nessuno

Osservazioni

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

Se WMI è abilitato, viene inviato un log di queste operazioni 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 fa effettivamente riferimento alla struttura passata (aumentare il 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 RxpTrackReference corrispondente per registrare le informazioni di diagnostica sulla richiesta prima di chiamare la routine RxReference corrispondente.

Per le compilazioni al dettaglio, questa funzione non fa nulla.