RxCreateNetRoot, fonction (fcb.h)

Article
02/06/2025

RxCreateNetRoot alloue et initialise une structure NET_ROOT et insère le nom dans la table de noms net sur l’objet d’appareil associé.

Syntaxe

PNET_ROOT RxCreateNetRoot(
  [in]           IN PSRV_CALL         SrvCall,
  [in]           IN PUNICODE_STRING   Name,
  [in]           IN ULONG             NetRootFlags,
  [in, optional] IN PRX_CONNECTION_ID RxConnectionId
);

Paramètres

[in] SrvCall

Pointeur vers la structure SRV_CALL associée.

[in] Name

Pointeur vers le nom à insérer dans la table de noms.

[in] NetRootFlags

Valeur permettant de définir les indicateurs membre du NET_ROOT utilisé pour indiquer l’état de la structure NET_ROOT.

[in, optional] RxConnectionId

Pointeur vers l’ID de connexion à associer au nom à insérer dans la table de noms de préfixe. Ce paramètre peut être null auquel cas aucun ID de connexion n’est associé au nom inséré dans la table de noms de préfixe.

Valeur de retour

RxCreateNetRoot retourne un pointeur vers une structure de données NET_ROOT nouvellement créée en cas de réussite ou de pointeur de NULL en cas d’échec.

Remarques

La routine RxCreateNetRoot n’est normalement pas appelée par les pilotes de mini-redirecteur réseau directement. RDBSS appelle cette routine en interne lorsqu’un paquet de demande d’E/S est reçu pour IRP_MJ_CREATE et qu’un NET_ROOT doit être créé. Cette IRP est normalement reçue par RDBSS en réponse à une application en mode utilisateur demandant une opération de création de fichier sur un partage réseau. Il est également possible pour un autre pilote de noyau d’émettre un tel IRP.

Avant d’appeler RxCreateNetRoot, un verrou sur la table de noms associée au membre de l’objet appareil du paramètre SrvCall doit être acquis en mode exclusif.

Les indicateurs NET_ROOT sont divisés en deux groupes, ceux visibles pour les mini redirecteurs réseau et ceux invisibles pour les mini redirecteurs réseau. Les indicateurs visibles sont les 16 bits inférieurs des indicateurs de membre du NET_ROOT. Cette routine ne vérifie pas ou ne teste pas les indicateurs en cours de définition.

En cas de réussite, le nombre de références de la structure SRV_CALL est incrémenté.