QNtfsPermissionCheckGuard Class
Die Klasse „QNtfsPermissionCheckGuard“ ist eine RAII-Klasse zur Verwaltung der NTFS-Berechtigungsprüfung. Mehr...
| Header: | #include <QNtfsPermissionCheckGuard> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Seit: | Qt 6.6 |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QNtfsPermissionCheckGuard ist Teil von „Eingabe/Ausgabe und Netzwerk“.
Öffentliche Funktionen
Verwandte Nicht-Mitglieder
(since 6.6) bool | qAreNtfsPermissionChecksEnabled() |
(since 6.6) bool | qDisableNtfsPermissionChecks() |
(since 6.6) bool | qEnableNtfsPermissionChecks() |
Ausführliche Beschreibung
Aus Leistungsgründen führen „ QFile “, „ QFileInfo “ und verwandte Klassen standardmäßig keine vollständige Überprüfung der Eigentumsrechte und Berechtigungen (ACL) auf NTFS-Dateisystemen durch. Während der Lebensdauer einer Instanz dieser Klasse wird diese Standardeinstellung außer Kraft gesetzt und eine erweiterte Überprüfung durchgeführt. Dies bietet eine sichere und einfache Möglichkeit, das Aktivieren und Deaktivieren dieser Änderung des Standardverhaltens zu verwalten.
Beispiel:
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 disabledDiese Klasse ist nur unter Windows verfügbar.
qt_ntfs_permission_lookup
Vor Qt 6.6 musste der Benutzer die globale Variable „ qt_ntfs_permission_lookup “ direkt bearbeiten. Da es sich hierbei jedoch um eine nicht-atomare globale Variable handelte, war sie anfällig für Datenkonflikte.
Die Variable ` qt_ntfs_permission_lookup ` ist daher seit Qt 6.6 veraltet.
Dokumentation zu den Member-Funktionen
QNtfsPermissionCheckGuard::QNtfsPermissionCheckGuard()
Erstellt eine Schutzfunktion und ruft die Funktion „ qEnableNtfsPermissionChecks()“ auf.
[noexcept] QNtfsPermissionCheckGuard::~QNtfsPermissionCheckGuard()
Löscht die Schutzklammer und ruft die Funktion „ qDisableNtfsPermissionChecks()“ auf.
Verwandte Nicht-Mitglieder
[noexcept, since 6.6] bool qAreNtfsPermissionChecksEnabled()
Überprüft den Status der Berechtigungsprüfungen auf NTFS-Dateisystemen. Gibt „ true “ zurück, wenn die Prüfung aktiviert ist.
Diese Funktion ist nur unter Windows verfügbar und macht die direkte Bearbeitung von „ qt_ntfs_permission_lookup “ überflüssig.
Hinweis: Die Thread-Sicherheit dieser Funktion gilt nur, solange keine gleichzeitigen Aktualisierungen von „ qt_ntfs_permission_lookup “ stattfinden.
Hinweis: Diese Funktion ist threadsicher.
Diese Funktion wurde in Qt 6.6 eingeführt.
[noexcept, since 6.6] bool qDisableNtfsPermissionChecks()
Deaktiviert die Berechtigungsprüfung auf NTFS-Dateisystemen. Gibt „ true “ zurück, wenn die Prüfung deaktiviert ist, was bedeutet, dass keine Benutzer mehr vorhanden sind.
Diese Funktion ist nur unter Windows verfügbar und macht die direkte Bearbeitung von ` qt_ntfs_permission_lookup ` überflüssig.
Es handelt sich um eine Low-Level-Funktion, die (nur) aufgerufen werden darf, um einem früheren Aufruf von ` qEnableNtfsPermissionChecks()` zu entsprechen. Bitte ziehen Sie stattdessen die RAII-Klasse ` QNtfsPermissionCheckGuard ` in Betracht.
Hinweis: Die Thread-Sicherheit dieser Funktion gilt nur, solange keine gleichzeitigen Aktualisierungen an ` qt_ntfs_permission_lookup` erfolgen.
Hinweis: Diese Funktion ist threadsicher.
Diese Funktion wurde in Qt 6.6 eingeführt.
[noexcept, since 6.6] bool qEnableNtfsPermissionChecks()
Aktiviert die Berechtigungsprüfung auf NTFS-Dateisystemen. Gibt „ true “ zurück, wenn die Prüfung bereits vor dem Aufruf dieser Funktion aktiviert war, was bedeutet, dass andere Benutzer vorhanden sind.
Diese Funktion ist nur unter Windows verfügbar und macht die direkte Bearbeitung von ` qt_ntfs_permission_lookup ` überflüssig.
Da es sich um eine Low-Level-Funktion handelt, sollten Sie stattdessen die RAII-Klasse ` QNtfsPermissionCheckGuard ` in Betracht ziehen.
Hinweis: Die Thread-Sicherheit dieser Funktion gilt nur, solange keine gleichzeitigen Aktualisierungen an ` qt_ntfs_permission_lookup` vorgenommen werden.
Hinweis: Diese Funktion ist threadsicher.
Diese Funktion wurde in Qt 6.6 eingeführt.
© 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.
