RxCreateNetFcb, fonction (fcb.h)

Article
02/06/2025

RxCreateNetFCB alloue, initialise et insère une nouvelle structure FCB dans les structures de données en mémoire pour une V_NET_ROOT sur laquelle ce FCB est ouvert. La structure allouée a de l’espace pour un SRV_OPEN et une structure FOBX.

Syntaxe

PFCB RxCreateNetFcb(
  [in] IN PRX_CONTEXT     RxContext,
  [in] IN PIRP            Irp,
  [in] IN PV_NET_ROOT     VNetRoot,
  [in] IN PUNICODE_STRING Name
);

Paramètres

[in] RxContext

Pointeur vers la structure RX_CONTEXT décrivant une opération de création.

[in] Irp

Pointeur vers l’IRP encapsulé par cette structure RX_CONTEXT.

[in] VNetRoot

Pointeur vers la structure V_NET_ROOT sur laquelle ce FCB est ouvert.

[in] Name

Nom du FCB. Le V_NET_ROOT peut contenir un préfixe de nom qui doit être ajouté ici.

Valeur de retour

RxCreateNetFCB retourne un pointeur vers une structure de données FCB nouvellement allouée en cas de réussite ou de pointeur NULL en cas d’échec.

Remarques

La routine RxCreateNetFCB 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 requête d’E/S est reçu pour IRP_MJ_CREATE et qu’une structure FCB doit être créée. 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.

Si le fcB à créer est un fichier de pagination, RxCreateNetFCB alloue de la mémoire du pool non paginé lors de la création de la structure de données FCB et définit l’indicateur suivant dans le membre FcbState du FCB :

Si le FCB à créer n’est pas un fichier de pagination, RxCreateNetFCB alloue de la mémoire du pool paginé lors de la création de la nouvelle structure de données FCB.

Windows n’autorise pas actuellement l’accès à un fichier de pagination sur un ordinateur distant.

Si le membre Create.Flags dans le RX_CONTEXT a l’indicateur RX_CONTEXT_CREATE_FLAG_ADDEDBACKSLASH activé, le membre FcbState du FCB a l’indicateur de FCB_STATE_ADDEDBACKSLASH activé.