En esta página

QNtfsPermissionCheckGuard Class

La clase QNtfsPermissionCheckGuard es una clase RAII destinada a gestionar la comprobación de permisos NTFS. Más información...

Cabecera: #include <QNtfsPermissionCheckGuard>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Desde: Qt 6.6

Funciones públicas

(since 6.6) bool qAreNtfsPermissionChecksEnabled()
(since 6.6) bool qDisableNtfsPermissionChecks()
(since 6.6) bool qEnableNtfsPermissionChecks()

Descripción detallada

Por motivos de rendimiento, QFile, QFileInfo y las clases relacionadas no realizan, de forma predeterminada, una comprobación completa de la propiedad y los permisos (ACL) en los sistemas de archivos NTFS. Durante el ciclo de vida de cualquier instancia de esta clase, se anula ese valor predeterminado y se lleva a cabo una comprobación avanzada. Esto proporciona una forma segura y sencilla de gestionar la activación y desactivación de este cambio en el comportamiento predeterminado.

Ejemplo:

void complexFunction()
{
    QNtfsPermissionCheckGuard permissionGuard;  // check is enabled

    // do complex things here that need permission check enabled

}   // as the guard goes out of scope the check is disabled

Esta clase solo está disponible en Windows.

qt_ntfs_permission_lookup

Antes de Qt 6.6, el usuario tenía que manipular directamente la variable global ` qt_ntfs_permission_lookup`. Sin embargo, se trataba de una variable global no atómica y, como tal, era propensa a conflictos de datos.

Por lo tanto, la variable qt_ntfs_permission_lookup ha quedado obsoleta a partir de Qt 6.6.

Documentación de las funciones miembro

QNtfsPermissionCheckGuard::QNtfsPermissionCheckGuard()

Crea un guard y llama a la función « qEnableNtfsPermissionChecks()».

[noexcept] QNtfsPermissionCheckGuard::~QNtfsPermissionCheckGuard()

Elimina el guard y llama a la función qDisableNtfsPermissionChecks().

Elementos no miembros relacionados

[noexcept, since 6.6] bool qAreNtfsPermissionChecksEnabled()

Comprueba el estado de las comprobaciones de permisos en los sistemas de archivos NTFS. Devuelve ` true ` si la comprobación está habilitada.

Esta función solo está disponible en Windows y hace que la manipulación directa de ` qt_ntfs_permission_lookup ` quede obsoleta.

Nota: La seguridad entre subprocesos de esta función solo se mantiene mientras no haya actualizaciones simultáneas en ` qt_ntfs_permission_lookup`.

Nota: Esta función es segura para subprocesos.

Esta función se introdujo en Qt 6.6.

[noexcept, since 6.6] bool qDisableNtfsPermissionChecks()

Desactiva la comprobación de permisos en los sistemas de archivos NTFS. Devuelve « true » si la comprobación está desactivada, lo que significa que ya no hay usuarios.

Esta función solo está disponible en Windows y hace que la manipulación directa de ` qt_ntfs_permission_lookup ` quede obsoleta.

Se trata de una función de bajo nivel y debe invocarse (únicamente) para corresponder a una llamada anterior a ` qEnableNtfsPermissionChecks()`. Se recomienda utilizar en su lugar la clase RAII ` QNtfsPermissionCheckGuard `.

Nota: La seguridad entre subprocesos de esta función solo se mantiene mientras no haya actualizaciones simultáneas en qt_ntfs_permission_lookup.

Nota: Esta función es segura para subprocesos.

Esta función se introdujo en Qt 6.6.

[noexcept, since 6.6] bool qEnableNtfsPermissionChecks()

Habilita la comprobación de permisos en los sistemas de archivos NTFS. Devuelve el valor « true » si la comprobación ya estaba habilitada antes de llamar a esta función, lo que significa que hay otros usuarios.

Esta función solo está disponible en Windows y hace que la manipulación directa de ` qt_ntfs_permission_lookup ` quede obsoleta.

Se trata de una función de bajo nivel; se recomienda utilizar en su lugar la clase RAII ` QNtfsPermissionCheckGuard `.

Nota: La seguridad de subprocesos de esta función solo se mantiene siempre y cuando no haya actualizaciones simultáneas en qt_ntfs_permission_lookup.

Nota: Esta función es segura para subprocesos.

Esta función se introdujo en Qt 6.6.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.