Función MmForceSectionClosedEx (ntifs.h)

La función MmForceSectionClosedEx examina los punteros de objeto de sección. Si son NULL, no se realiza ninguna otra acción y se devuelve el valor TRUE.

Si el puntero del objeto de sección no es NULL, se comprueba el recuento de referencias de sección y el recuento de vistas de mapa. Si ambos recuentos son cero, se elimina el segmento asociado al archivo y se cierra el archivo. Si uno de los recuentos es distinto de cero, no se realiza ninguna acción y se devuelve el valor FALSE.

Sintaxis

BOOLEAN MmForceSectionClosedEx(
  PSECTION_OBJECT_POINTERS SectionObjectPointer,
  ULONG                    ForceCloseFlags
);

Parámetros

SectionObjectPointer

Especifica un puntero al objeto SECTION_OBJECT_POINTERS .

ForceCloseFlags

Contiene marcas que indican si la sección debe marcarse para cerrarse más adelante (lo antes posible) en el caso de que esta sección no se pueda cerrar ahora debido a referencias pendientes.

Contiene una de las marcas siguientes:

• MM_FORCE_CLOSED_LATER_OK si la sección debe marcarse para cerrarse inmediatamente en caso de que no se pueda cerrar la sección debido a referencias pendientes.

• MM_FORCE_CLOSED_DATA forzar el cierre de la sección de datos.

• MM_FORCE_CLOSED_IMAGE forzar el cierre de la sección de imagen.

Valor devuelto

Esta función devuelve TRUE si se eliminó el segmento y se ha cerrado el archivo o no se ha localizado ningún segmento. Si se especifica más de un tipo de segmento (datos o imagen), ambos deben eliminarse correctamente para que se devuelva TRUE.

Esta función devuelve FALSE si el segmento no se eliminó.

Requisitos