RxCreateNetFobx, fonction (fcb.h)

Article
02/06/2025

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 pour une instance FCB sur laquelle 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 de retour

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 essayera 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 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 la structure FCB associée et SRV_OPEN ne sont pas disponibles, RxCreateNetFobx alloue 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.

Windows n’autorise pas actuellement l’accès à 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 est défini sur 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.
Les indicateurs membre sont définis sur une valeur basée sur les paramètres de l’RX_CONTEXT et indiquent si un nouveau FOBX doit être alloué.

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