Función RxCreateSrvOpen (fcb.h)

Artículo
02/06/2025

RxCreateSrvOpen asigna, inicializa e inserta una nueva estructura de SRV_OPEN en las estructuras de datos en memoria usadas por RDBSS. Si se debe asignar una nueva estructura, tiene espacio para una estructura FOBX.

Sintaxis

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

Parámetros

[in] VNetRoot

Puntero a la estructura V_NET_ROOT.

[in, out] Fcb

Puntero a la estructura FCB asociada.

Valor devuelto

RxCreateSrvOpen devuelve un puntero a una estructura de datos de SRV_OPEN recién creada cuando se ejecuta correctamente o un puntero de NULL en caso de error.

Observaciones

Normalmente, los controladores de minidirector de red no llaman a la rutina de RxCreateSrvOpen. RDBSS llama a esta rutina internamente cuando se recibe un paquete de solicitud de E/S para IRP_MJ_CREATE y se debe crear un SRV_OPEN. 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.

Antes de llamar a RxCreateSrvOpen, se debe adquirir un bloqueo en la estructura FCB asociada en modo exclusivo.

RxCreateSrvOpen intentará usar la SRV_CALL asignada como parte de la estructura FCB asociada si está disponible. Si el SRV_CALL asignado con el FCB no está disponible, RxCreateSrvOpen asignará una nueva estructura de SRV_CALL.

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

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