Fonction RxFinalizeNetRoot (fcb.h)

Article
03/01/2024

RxFinalizeNetRoot finalise la structure NET_ROOT donnée. L’appelant doit disposer d’un verrou exclusif sur la table netname associé à l’objet d’appareil.

Syntaxe

BOOLEAN RxFinalizeNetRoot(
  [out] OUT PNET_ROOT ThisNetRoot,
  [in]  IN BOOLEAN    RecursiveFinalize,
  [in]  IN BOOLEAN    ForceFinalize
);

Paramètres

[out] ThisNetRoot

Pointeur vers la structure NET_ROOT à finaliser.

[in] RecursiveFinalize

Valeur indiquant si la finalisation doit être effectuée de manière récursive.

[in] ForceFinalize

Valeur indiquant si la finalisation doit être forcée, quel que soit le nombre de références.

Si ForceFinalize a la valeur FALSE, le membre NodeReferenceCount de la strcuture NET_ROOT pointée par ThisNetRoot doit avoir la valeur 1 pour que le NET_ROOT soit finalisé.

Valeur retournée

RxFinalizeNetRoot retourne TRUE en cas de réussite ou FALSE si la finalisation n’a pas eu lieu : si une finalisation du NET_ROOT est déjà en cours de traitement, RxFinalizeNetRoot retourne FALSE.

Remarques

La routine RxFinalizeNetRoot n’est normalement pas appelée directement par les pilotes de mini-redirecteur réseau. RDBSS appelle cette routine en interne lorsque le nombre de références sur le NET_ROOT est décrémenté à 1.

Avant d’appeler RxFinalizeNetRoot, un verrou sur la table netname associée à l’objet d’appareil doit être acquis en mode exclusif.

Si le paramètre RecursiveFinalize a la valeur TRUE, RxFinalizeNetRoot purgera toutes les structures FCB orphelines associées à cette NET_ROOT. Ces fcbs ophaned sont des structures sur lesquelles le membre FcbState a l’indicateur FCB_STATE_ORPHANED défini.