RxCreateNetFcb, fonction (fcb.h)

Article
02/29/2024

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 retournée

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

Remarques

La routine RxCreateNetFCB 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’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 de pool non paginée lors de la création de la structure de données FCB et définit l’indicateur suivant sur 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.

Actuellement, Windows n’autorise pas la création d’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 FCB_STATE_ADDEDBACKSLASH activé.