QNtfsPermissionCheckGuard Class
La classe QNtfsPermissionCheckGuard est une classe RAII permettant de gérer la vérification des autorisations NTFS. En savoir plus...
| En-tête : | #include <QNtfsPermissionCheckGuard> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
| Depuis : | Qt 6.6 |
- Liste de tous les membres, y compris les membres hérités
- QNtfsPermissionCheckGuard fait partie de la catégorie « Entrée/Sortie et réseau ».
Fonctions publiques
Éléments non membres associés
(since 6.6) bool | qAreNtfsPermissionChecksEnabled() |
(since 6.6) bool | qDisableNtfsPermissionChecks() |
(since 6.6) bool | qEnableNtfsPermissionChecks() |
Description détaillée
Pour des raisons de performances, les classes ` QFile`, ` QFileInfo` et les classes associées n'effectuent pas, par défaut, de vérification complète des droits de propriété et des autorisations (ACL) sur les systèmes de fichiers NTFS. Pendant la durée de vie de toute instance de cette classe, ce comportement par défaut est remplacé et une vérification avancée est effectuée. Cela offre un moyen simple et sécurisé de gérer l'activation et la désactivation de cette modification du comportement par défaut.
Exemple :
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 disabledCette classe n’est disponible que sous Windows.
qt_ntfs_permission_lookup
Avant Qt 6.6, l’utilisateur devait manipuler directement la variable globale ` qt_ntfs_permission_lookup`. Cependant, il s’agissait d’une variable globale non atomique et, à ce titre, elle était sujette à des conflits d’accès.
La variable qt_ntfs_permission_lookup est donc dépréciée depuis Qt 6.6.
Documentation des fonctions membres
QNtfsPermissionCheckGuard::QNtfsPermissionCheckGuard()
Crée un garde et appelle la fonction ` qEnableNtfsPermissionChecks()`.
[noexcept] QNtfsPermissionCheckGuard::~QNtfsPermissionCheckGuard()
Supprime le garde et appelle la fonction qDisableNtfsPermissionChecks().
Éléments non membres associés
[noexcept, since 6.6] bool qAreNtfsPermissionChecksEnabled()
Vérifie l'état des contrôles d'autorisation sur les systèmes de fichiers NTFS. Renvoie « true » si le contrôle est activé.
Cette fonction n’est disponible que sous Windows et rend obsolète la manipulation directe de ` qt_ntfs_permission_lookup `.
Remarque : la sécurité inter-threads de cette fonction n'est garantie que tant qu'il n'y a pas de mises à jour simultanées de qt_ntfs_permission_lookup.
Remarque : cette fonction est thread-safe.
Cette fonction a été introduite dans Qt 6.6.
[noexcept, since 6.6] bool qDisableNtfsPermissionChecks()
Désactive la vérification des droits d'accès sur les systèmes de fichiers NTFS. Renvoie « true » si la vérification est désactivée, ce qui signifie qu'il n'y a plus d'utilisateurs.
Cette fonction n’est disponible que sous Windows et rend obsolète la manipulation directe de ` qt_ntfs_permission_lookup `.
Il s’agit d’une fonction de bas niveau qui doit (uniquement) être appelée pour correspondre à un appel antérieur à ` qEnableNtfsPermissionChecks()`. Veuillez plutôt envisager d’utiliser la classe RAII ` QNtfsPermissionCheckGuard `.
Remarque : la sécurité inter-thread de cette fonction n’est garantie que tant qu’il n’y a pas de mises à jour simultanées de ` qt_ntfs_permission_lookup`.
Remarque : cette fonction est sûre pour les threads.
Cette fonction a été introduite dans Qt 6.6.
[noexcept, since 6.6] bool qEnableNtfsPermissionChecks()
Active la vérification des autorisations sur les systèmes de fichiers NTFS. Renvoie « true » si la vérification était déjà activée avant l'appel de cette fonction, ce qui signifie qu'il existe d'autres utilisateurs.
Cette fonction n'est disponible que sous Windows et rend obsolète la manipulation directe de ` qt_ntfs_permission_lookup `.
Il s'agit d'une fonction de bas niveau ; privilégiez plutôt la classe RAII ` QNtfsPermissionCheckGuard `.
Remarque : la sécurité inter-threads de cette fonction n'est garantie que tant qu'il n'y a pas de mises à jour simultanées sur ` qt_ntfs_permission_lookup`.
Remarque : cette fonction est sûre pour les threads.
Cette fonction a été introduite dans 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.
