Función RxFinishFcbInitialization (fcb.h)

Artículo
10/07/2023

RxFinishFcbInitialization se usa para finalizar la inicialización de un FCB después de completar correctamente una operación de creación mediante el minidirector de red.

Sintaxis

void RxFinishFcbInitialization(
  IN OUT PMRX_FCB     Fcb,
  IN RX_FILE_TYPE     FileType,
  IN PFCB_INIT_PACKET InitPacket
);

Parámetros

Fcb

Puntero a la estructura MRX_FCB que se va a inicializar.

FileType

Valor que indica el tipo de almacenamiento de la entidad a la que hace referencia el FCB. Entre las opciones posibles para este parámetro se incluyen las siguientes:

Valor	Significado
RDBSS_NTC_MAILSLOT	Ranura de correo.
RDBSS_NTC_SPOOLFILE	Un archivo de cola de impresora.
RDBSS_NTC_STORAGE_TYPE_DIRECTORY	Un directorio.
RDBSS_NTC_STORAGE_TYPE_UNKNOWN	El tipo de almacenamiento es desconocido.
RDBSS_NTC_STORAGE_TYPE_FILE	Un archivo.

InitPacket

Puntero a datos adicionales necesarios para la inicialización en función del tipo de almacenamiento del FCB que se va a inicializar. Este parámetro puede ser un puntero NULL si no se proporciona ningún dato adicional.

Valor devuelto

None

Observaciones

Cuando se llama como resultado de un IRP_MJ_CREATE, primero se llama a RxCreateNetFCB para crear el FCB. Si el miembro Type del NET_ROOT que se va a crear no es un NET_ROOT_MAILSLOT, se llama a RxFinishFcbInitialization para finalizar la inicialización de la estructura FCB.

Si el miembro FcbState de la estructura de MRX_FCB a la que apunta MrxFcb no tiene el FCB_STATE_TIME_AND_SIZE_ALREADY_SET activado, los siguientes miembros del FCB se actualizarán desde el parámetro InitPacket si InitPacket no es NULL: Attributes, NumberOfLinks, CreationTime, LastAccessTime, LastWriteTime, LastChangeTime, ActualAllocationLength, Header.AllocationSize, Header.FileSize y Header.ValidDataLength. La opción FCB_STATE_TIME_AND_SIZE_ALREADY_SET se establece en en el miembro FcbState de la estructura FCB.

Si el tipo de almacenamiento es un RDBSS_NTC_MAILSLOT y el miembro FcbState del FCB tiene la opción FCB_STATE_TIME_AND_SIZE_ALREADY_SET establecida, los siguientes miembros de la estructura FCB para la ranura de correo se inicializarán en 0: Atributos, NumberOfLinks, CreationTime.QuadPart, LastAccessTime.QuadPart, LastWriteTime.QuadPart, LastChangeTime. QuadPart, ActualAllocationLength, Header.AllocationSize.QuadPart, Header.FileSize.QuadPart y Header.ValidDataLength.QuadPart