Fonction RxCreateNetFobx (fcb.h)

Article
08/07/2023

RxCreateNetFobx alloue, initialise et insère une nouvelle structure d’extension d’objet de fichier (FOBX) dans les structures de données en mémoire d’un FCB sur lequel ce FOBX est ouvert.

Syntaxe

PMRX_FOBX RxCreateNetFobx(
  [out] OUT PRX_CONTEXT  RxContext,
  [in]  IN PMRX_SRV_OPEN MrxSrvOpen
);

Paramètres

[out] RxContext

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

[in] MrxSrvOpen

Pointeur vers la structure SRV_OPEN associée.

Valeur retournée

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

Remarques

Les mini-redirecteurs réseau doivent appeler RxCreateNetFobx pour créer un FOBX à la fin d’une opération de création réussie.

Avant d’appeler RxCreateNetFobx, le FCB associé à la structure FOBX doit être acquis en mode exclusif.

RxCreateNetFobx essaiera d’utiliser le FOBX alloué dans le cadre de la structure FCB associée, s’il est disponible. Si le FOBX alloué avec le FCB n’est pas disponible, RxCreateNetFobx essaiera d’utiliser le FOBX alloué dans le cadre de la structure de SRV_OPEN associée s’il est disponible. Dans l’un de ces cas, RxCreateNetFobx doit uniquement initialiser la structure FOBX existante, aucune allocation de mémoire n’est requise. Si les deux structures FOBX sur le FCB associé et SRV_OPEN structure ne sont pas disponibles, RxCreateNetFobx allouera une nouvelle structure FOBX.

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

Actuellement, Windows n’autorise pas d’avoir un fichier de pagination sur un ordinateur distant.

En cas de réussite, les membres FOBX suivants dans la structure FOBX sont définis :

Le membre NodeReference a la valeur 1.
Le membre FobxSerialNumber a la valeur 0.
Le membre SrvOpen est défini sur la structure SRV_OPEN associée.
Le membre fOpenCountDecremented a la valeur FALSE.
Le membre Flags est défini sur une valeur en fonction des paramètres du RX_CONTEXT et de la nécessité d’allouer un nouveau FOBX.

En cas de réussite, le nombre de références pour la structure SRV_OPEN est incrémenté et le membre NumberOfFobxs sur la structure V_NET_ROOT associée est incrémenté.