QNtfsPermissionCheckGuard Class
La classe QNtfsPermissionCheckGuard est une classe RAII permettant de gérer le contrôle des autorisations NTFS. Plus d'informations...
| 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 Entrées/Sorties et Réseaux.
Fonctions publiques
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, QFile, QFileInfo, et les classes apparentées n'effectuent pas, par défaut, de vérification complète de la 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, cette valeur par défaut est remplacée et une vérification avancée est effectuée. Il s'agit d'un moyen sûr et simple 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 disabled
Cette 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, en tant que telle, elle était sujette à des courses de données.
La variable qt_ntfs_permission_lookup est donc obsolète depuis Qt 6.6.
Documentation des fonctions membres
QNtfsPermissionCheckGuard::QNtfsPermissionCheckGuard()
Crée une garde et appelle la fonction qEnableNtfsPermissionChecks().
[noexcept] QNtfsPermissionCheckGuard::~QNtfsPermissionCheckGuard()
Détruit la garde et appelle la fonction qDisableNtfsPermissionChecks().
Non-membres apparentés
[noexcept, since 6.6] bool qAreNtfsPermissionChecksEnabled()
Vérifie l'état des contrôles de permission 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é thread de cette fonction n'est assurée que tant qu'il n'y a pas de mises à jour simultanées de qt_ntfs_permission_lookup.
Note : Cette fonction est sans risque pour les threads.
Cette fonction a été introduite dans Qt 6.6.
[noexcept, since 6.6] bool qDisableNtfsPermissionChecks()
Désactive le contrôle des autorisations sur les systèmes de fichiers NTFS. Renvoie true si le contrôle est désactivé, 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 considérer la classe RAII QNtfsPermissionCheckGuard à la place.
Remarque : la sécurité thread de cette fonction ne vaut que tant qu'il n'y a pas de mises à jour simultanées de qt_ntfs_permission_lookup.
Note : Cette fonction est sans risque pour les threads.
Cette fonction a été introduite dans Qt 6.6.
[noexcept, since 6.6] bool qEnableNtfsPermissionChecks()
Active le contrôle des autorisations sur les systèmes de fichiers NTFS. Renvoie true si le contrôle était déjà activé avant l'appel à cette fonction, ce qui signifie qu'il y a 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, veuillez considérer la classe RAII QNtfsPermissionCheckGuard à la place.
Remarque : la sécurité thread de cette fonction ne vaut que tant qu'il n'y a pas de mises à jour simultanées de qt_ntfs_permission_lookup.
Note : Cette fonction est sans risque 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.
