Función RxCreateNetFcb (fcb.h)

Artículo
08/07/2023

RxCreateNetFCB asigna, inicializa e inserta una nueva estructura FCB en las estructuras de datos en memoria para una V_NET_ROOT en la que se abre este FCB. La estructura asignada tiene espacio para un SRV_OPEN y una estructura FOBX.

Sintaxis

PFCB RxCreateNetFcb(
  [in] IN PRX_CONTEXT     RxContext,
  [in] IN PIRP            Irp,
  [in] IN PV_NET_ROOT     VNetRoot,
  [in] IN PUNICODE_STRING Name
);

Parámetros

[in] RxContext

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

[in] Irp

Puntero al IRP encapsulado por esta estructura RX_CONTEXT.

[in] VNetRoot

Puntero a la estructura V_NET_ROOT en la que se abre este FCB.

[in] Name

Nombre del FCB. El V_NET_ROOT puede contener un prefijo de nombre que se va a anteponer aquí.

Valor devuelto

RxCreateNetFCB devuelve un puntero a una estructura de datos FCB recién asignada si se ejecuta correctamente o un puntero NULL en caso de error.

Comentarios

Normalmente, los controladores de minidirector de red no llaman a la rutina RxCreateNetFCB . RDBSS llama a esta rutina internamente cuando se recibe un paquete de solicitud de E/S para IRP_MJ_CREATE y es necesario crear una estructura FCB. RdBSS recibe normalmente este IRP en respuesta a una aplicación en modo de usuario que solicita una operación de creación de archivos en un recurso compartido de red. También es posible que otro controlador de kernel emita este tipo de IRP.

Si el FCB que se va a crear es un archivo de paginación, RxCreateNetFCB asigna memoria de grupo no paginada al crear la nueva estructura de datos FCB y establece la marca siguiente en el miembro FcbState del FCB:

Si el FCB que se va a crear no es un archivo de paginación, RxCreateNetFCB asigna memoria de grupo paginada al crear la nueva estructura de datos FCB.

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

Si el miembro Create.Flags del RX_CONTEXT tiene activada la marca RX_CONTEXT_CREATE_FLAG_ADDEDBACKSLASH, el miembro FcbState del FCB tiene la marca FCB_STATE_ADDEDBACKSLASH establecida.