Fonction RxCreateNetRoot (fcb.h)

Article
02/26/2024

RxCreateNetRoot alloue et initialise une structure de NET_ROOT et insère le nom dans la table de nom 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 le membre Flags du NET_ROOT qui est utilisé pour désigner 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éfixes. Ce paramètre peut avoir la valeur NULL , auquel cas aucun ID de connexion n’est associé au nom inséré dans la table de noms de préfixes.

Valeur retournée

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

Remarques

La routine RxCreateNetRoot n’est normalement pas appelée directement par les pilotes de mini-redirecteur réseau. 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 d’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 éléments visibles sont les 16 bits inférieurs du membre Flags du NET_ROOT. Cette routine ne case activée ni ne teste les indicateurs en cours de définition.

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