Back to Qt.io
Contact Us Blog Download Qt

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()
~QNtfsPermissionCheckGuard()
(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_ntfs_permission_lookup 변수는 Qt 6.6부터 더 이상 사용되지 않습니다.

멤버 함수 문서

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 의 직접 조작을 쓸모없게 만듭니다.

이 함수는 저수준 함수이므로 대신 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.