RxCreateVNetRoot, fonction (fcb.h)

Article
03/01/2024

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

Syntaxe

PV_NET_ROOT RxCreateVNetRoot(
  [in] IN PRX_CONTEXT       RxContext,
  [in] IN PNET_ROOT         NetRoot,
  [in] IN PUNICODE_STRING   CanonicalName,
  [in] IN PUNICODE_STRING   LocalNetRootName,
  [in] IN PUNICODE_STRING   FilePath,
  [in] IN PRX_CONNECTION_ID RxConnectionId
);

Paramètres

[in] RxContext

Pointeur vers le RX_CONTEXT RDBSS contenant l’IRP décrivant une opération de création.

[in] NetRoot

Pointeur vers la structure de NET_ROOT associée.

[in] CanonicalName

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

[in] LocalNetRootName

Pointeur vers le nom du NET_ROOT local sans le nom de préfixe.

[in] FilePath

Pointeur vers un chemin d’accès de fichier. Ce paramètre n’est pas utilisé actuellement et peut être NULL.

[in] RxConnectionId

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

Valeur retournée

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

Remarques

La routine RxCreateVNetRoot 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 V_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 RxCreateVNetRoot, un verrou sur la table de noms associée au membre de l’objet d’appareil du paramètre RxContext doit être acquis en mode exclusif.

RxCreateVNetRoot définit divers paramètres de contexte de sécurité sur la structure V_NET_ROOT en fonction des paramètres du RX_CONTEXT. Ces paramètres incluent les éléments suivants : LogonId, SessionId, pUserName, pUserDomainName, pPassword et Flags.