QNtfsPermissionCheckGuard Class
QNtfsPermissionCheckGuardクラスは、NTFSのパーミッションチェックを管理するRAIIクラスです。詳細...
| ヘッダー | #include <QNtfsPermissionCheckGuard> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake： | QT += core |
| 以来： | Qt 6.6 |
- 継承されたメンバを含む、すべてのメンバの一覧
- QNtfsPermissionCheckGuard はInput/Output と Networking に属しています。
パブリック関数
関連する非メンバー
(since 6.6) bool | qAreNtfsPermissionChecksEnabled() |
(since 6.6) bool | qDisableNtfsPermissionChecks() |
(since 6.6) bool | qEnableNtfsPermissionChecks() |
詳細説明
パフォーマンス上の理由から、QFile 、QFileInfo 、および関連するクラスは、デフォルトで NTFS ファイル・システムの完全な所有権とアクセス許可（ACL）チェックを実行しません。このクラスのインスタンスの存続期間中は、このデフォルトがオーバーライドされ、高度なチェックが実行されます。これにより、この既定の動作への変更を有効または無効にする安全で簡単な管理方法が提供されます。
例
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
このクラスは Windows でのみ使用可能です。
qt_ntfs_permission_lookup
Qt 6.6以前では、ユーザーはグローバル変数qt_ntfs_permission_lookup を直接操作する必要がありました。しかし、これは非アトミックなグローバル変数であったため、データ競合が起こりやすかったのです。
そのため、Qt 6.6以降、変数qt_ntfs_permission_lookup は非推奨となりました。
メンバ関数のドキュメント
QNtfsPermissionCheckGuard::QNtfsPermissionCheckGuard()
ガードを作成し、関数qEnableNtfsPermissionChecks() を呼び出す。
[noexcept] QNtfsPermissionCheckGuard::~QNtfsPermissionCheckGuard()
ガードを破棄し、関数qDisableNtfsPermissionChecks() を呼び出す。
関連する非会員
[noexcept, since 6.6] bool qAreNtfsPermissionChecksEnabled()
NTFSファイルシステムのパーミッション・チェックのステータスをチェックする。チェックが有効な場合はtrue を返す。
この関数は Windows でのみ使用可能であり、qt_ntfs_permission_lookup を直接操作することは廃止される。
注意: この関数のスレッドセーフは、qt_ntfs_permission_lookup への同時更新がない限り維持される。
注意：この関数はスレッドセーフです。
この関数は Qt 6.6 で導入されました。
[noexcept, since 6.6] bool qDisableNtfsPermissionChecks()
NTFSファイルシステムのパーミッション・チェックを無効にする。チェックが無効な場合は、true を返す。これは、もうユーザーがいないことを意味する。
この関数は Windows でのみ利用可能であり、qt_ntfs_permission_lookup を直接操作することは廃止される。
この関数は低レベル関数であり、qEnableNtfsPermissionChecks() を先に呼び出した場合にマッチするように（のみ）呼び出されなければならない。代わりにRAIIクラスQNtfsPermissionCheckGuard 。
注意 : この関数のスレッドセーフは、qt_ntfs_permission_lookup への同時更新がない限り保持される。
注意: この関数はスレッドセーフです。
この関数は Qt 6.6 で導入されました。
[noexcept, since 6.6] bool qEnableNtfsPermissionChecks()
NTFSファイルシステムのパーミッション・チェックを有効にする。この関数を呼び出す前にすでにチェックが有効になっていた場合、つまり他のユーザーが存在する場合はtrue を返す。
この関数は Windows でのみ使用可能であり、qt_ntfs_permission_lookup を直接操作することは廃止される。
これは低レベルの関数なので、代わりにRAIIクラスQNtfsPermissionCheckGuard 。
注意 : この関数のスレッドセーフは、qt_ntfs_permission_lookup への同時更新がない限り保持されます。
注意: この関数はスレッドセーフです。
この関数は Qt 6.6 で導入されました。
© 2025 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.
