RxpDereferenceNetFcb, fonction (fcb.h)
RxpDereferenceNetFcb décrémente le nombre de références sur une structure FCB.
Syntaxe
LONG RxpDereferenceNetFcb(
PFCB Fcb
);
Paramètres
Fcb
Pointeur vers la structure FCB à déréférer.
Valeur de retour
RxpDereferenceNetFcb retourne le nombre de références final après la déréférence.
Remarques
Le référencement et la déréférencement des bases de données sont différents de ceux des autres structures de données en raison de la ressource incorporée dans le FCB. Cela implique que l’appelant exige des informations concernant l’état du FCB (qu’il ait été finalisé ou non). Pour finaliser le fcB, deux verrous doivent être conservés, le verrou de table de noms NET_ROOT ainsi que la ressource FCB. Ces considérations mènent à une approche différente dans la déreferencation des bases de données. Par conséquent, RxpDereferenceNetFcb ne tente pas de finaliser le FCB.
Un certain nombre de macros sont définies dans fcb.h pour le débogage qui sont le moyen préféré d’appeler cette routine. Ces macros fournissent un wrapper autour des routines RxpReferenceNetFcb ou RxpDereferenceNetFcb utilisées pour les opérations de gestion de structure de fichiers sur les structures FCB. La macro RxDereferenceNetFcb est la méthode recommandée pour appeler cette routine. Cette macro appelle d’abord la routine RxpTrackDereference pour journaliser les informations de diagnostic sur la demande avant d’appeler la routine RxpDereferenceNetFcb.
Sur les builds vérifiées, RxpDereferenceNetFcb entraîne l’assertion du système si le type de nœud de la structure n’est pas un FCB ou si le nombre de références final est inférieur à 0.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | fcb.h (include Fcb.h) |
| IRQL | <= APC_LEVEL |