Función RxCreateNetFobx (fcb.h)

Artículo
08/07/2023

RxCreateNetFobx asigna, inicializa e inserta una nueva estructura de extensión de objeto de archivo (FOBX) en las estructuras de datos en memoria de un FCB en el que se abre este FOBX.

Sintaxis

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

Parámetros

[out] RxContext

Puntero a la estructura RX_CONTEXT que describe una operación de creación.

[in] MrxSrvOpen

Puntero a la estructura de SRV_OPEN asociada.

Valor devuelto

RxCreateNetFobx devuelve un puntero a una estructura de datos FOBX recién asignada cuando se ejecuta correctamente o un puntero NULL en caso de error.

Comentarios

Los mini redireccionadores de red deben llamar a RxCreateNetFobx para crear un FOBX al final de una operación de creación correcta.

Antes de llamar a RxCreateNetFobx, el FCB asociado a la estructura FOBX debe adquirirse en modo exclusivo.

RxCreateNetFobx intentará usar el FOBX asignado como parte de la estructura FCB asociada si está disponible. Si el FOBX asignado con el FCB no está disponible, RxCreateNetFobx intentará usar el FOBX asignado como parte de la estructura de SRV_OPEN asociada si está disponible. En cualquiera de estos casos, RxCreateNetFobx solo necesita inicializar la estructura FOBX existente, no se requiere ninguna asignación de memoria. Si las dos estructuras FOBX en la estructura FCB asociada y SRV_OPEN no están disponibles, RxCreateNetFobx asignará una nueva estructura FOBX.

Si el FCB asociado es un archivo de paginación, RxCreateNetFobx asigna memoria de grupo no paginada al crear la nueva estructura de datos FOBX. Si el FCB asociado no es un archivo de paginación, RxCreateNetFobx asigna memoria de grupo paginada al crear la nueva estructura de datos FOBX.

Windows no permite actualmente tener un archivo de paginación en un equipo remoto.

Si se ejecuta correctamente, se establecen los siguientes miembros FOBX en la estructura FOBX:

El miembro NodeReference se establece en 1.
El miembro FobxSerialNumber se establece en 0.
El miembro SrvOpen se establece en la estructura de SRV_OPEN asociada.
El miembro fOpenCountDecremented se establece en FALSE.
El miembro Flags se establece en un valor basado en parámetros de la RX_CONTEXT y si es necesario asignar un nuevo FOBX.

Si se ejecuta correctamente, se incrementa el recuento de referencias de la estructura SRV_OPEN y se incrementa el miembro NumberOfFobxs en la estructura de V_NET_ROOT asociada.