RxCreateSrvOpen, fonction (fcb.h)

Article
02/06/2025

RxCreateSrvOpen alloue, initialise et insère une nouvelle structure de SRV_OPEN dans les structures de données en mémoire utilisées par RDBSS. Si une nouvelle structure doit être allouée, elle a de l’espace pour une structure FOBX.

Syntaxe

PSRV_OPEN RxCreateSrvOpen(
  [in]      IN PV_NET_ROOT VNetRoot,
  [in, out] IN OUT PFCB    Fcb
);

Paramètres

[in] VNetRoot

Pointeur vers la structure V_NET_ROOT.

[in, out] Fcb

Pointeur vers la structure FCB associée.

Valeur de retour

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

Remarques

La routine RxCreateSrvOpen 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’un SRV_OPEN 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 RxCreateSrvOpen, un verrou sur la structure FCB associée doit être acquis en mode exclusif.

RxCreateSrvOpen essaiera d’utiliser le SRV_CALL alloué dans le cadre de la structure FCB associée s’il est disponible. Si l’SRV_CALL allouée avec le FCB n’est pas disponible, RxCreateSrvOpen alloue une nouvelle structure de SRV_CALL.

Si le fcB associé est un fichier de pagination, RxCreateSrvOpen alloue de la mémoire du pool non paginé lors de la création de la structure de données SRV_OPEN. Si le fcB associé n’est pas un fichier de pagination, RxCreateSrvOpen alloue de la mémoire du pool paginé lors de la création de la structure de données SRV_OPEN.

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