다음을 통해 공유


DiskQuotaControl 개체

관리자가 볼륨의 디스크 할당량 속성을 관리할 수 있습니다. NTFS 파일 시스템을 사용하면 관리자가 각 사용자에게 지정된 양의 디스크 공간 또는 할당량 제한을 할당하여 공유 볼륨의 디스크 사용량을 관리할 수 있습니다. 이 개체를 사용하여 모든 새 사용자에게 자동으로 할당되는 기본 할당량 제한을 설정할 수 있습니다.

멤버

DiskQuotaControl 개체에는 다음과 같은 유형의 멤버가 있습니다.

이벤트

DiskQuotaControl 개체에는 이러한 이벤트가 있습니다.

이벤트 설명
OnUserNameChanged DIDiskQuotaUser 개체의 이름 정보가 확인되면 발생합니다.

 

메서드

DiskQuotaControl 개체에는 이러한 메서드가 있습니다.

메서드 Description
AddUser 새 사용자에게 기본이 아닌 디스크 할당량을 할당합니다.
DeleteUser 볼륨에서 사용자를 삭제합니다.
FindUser 볼륨의 할당량 파일에서 이름별로 사용자의 항목을 찾습니다.
GiveUserNameResolutionPriority 이름 확인을 위해 지정한 사용자 개체를 줄에 배치합니다.
초기화 지정된 볼륨을 열고 할당량 제어 개체를 초기화합니다.
InvalidateSidNameCache 보안 ID 사용자 이름 캐시를 무효화합니다.
ShutdownNameResolution 사용자 이름 확인 스레드를 종료합니다.
TranslateLogonNameToSID 로그온 이름을 문자열 형식의 해당 사용자 보안 ID로 변환합니다.

 

속성

DiskQuotaControl 개체에는 이러한 속성이 있습니다.

속성 액세스 유형 설명
DefaultQuotaLimit
읽기/쓰기
기본 할당량 제한을 설정하거나 가져옵니다.
DefaultQuotaLimitText
읽기 전용
텍스트 문자열로 기본 할당량 제한을 가져옵니다.
DefaultQuotaThreshold
읽기/쓰기
기본 할당량 임계값을 설정하거나 가져옵니다.
DefaultQuotaThresholdText
읽기 전용
기본 할당량 임계값을 텍스트 문자열로 가져옵니다.
LogQuotaLimit
읽기/쓰기
사용자가 할당된 할당량 한도를 초과할 때 시스템 이벤트 로그 항목이 생성되는지 여부를 나타내는 부울 값을 설정하거나 가져옵니다.
LogQuotaThreshold
읽기/쓰기
사용자가 할당된 할당량 임계값을 초과할 때 시스템 이벤트 로그 항목이 생성되는지 여부를 나타내는 부울 값을 설정하거나 가져옵니다.
QuotaFileIncomplete
읽기 전용
볼륨의 할당량 파일이 완료되었는지 여부를 나타내는 부울 값을 가져옵니다.
QuotaFileRebuilding
읽기 전용
볼륨의 할당량 파일이 현재 다시 작성되고 있는지 여부를 나타내는 부울 값을 가져옵니다.
QuotaState
읽기/쓰기
볼륨의 디스크 할당량 상태를 설정하거나 가져옵니다.
UserNameResolution
읽기/쓰기
사용자 SID를 사용자 이름으로 확인하는 방법을 제어하는 값을 설정하거나 가져옵니다.

 

설명

관리자는 DiskQuotaControl 개체를 사용하여 다음을 비롯한 다양한 작업을 수행할 수 있습니다.

  • 볼륨의 디스크 할당량 시스템을 사용하도록 설정하고 사용하지 않도록 설정합니다.
  • 볼륨에서 할당량 시스템의 상태 가져옵니다.
  • 할당량 한도를 초과하는 사용자에게 디스크 공간을 거부합니다.
  • 새 사용자에게 할당할 기본 경고 임계값 및 할당량 제한 값을 지정합니다.
  • 사용자 추가 및 제거.

DiskQuotaControl 개체를 사용하면 할당량 제한과 같은 속성의 볼륨에 대한 전역 기본값을 설정할 수 있습니다. 그러나 각 사용자는 개별 할당량 설정을 지정하는 데 사용할 수 있는 DIDiskQuotaUser 개체로 표시됩니다.

사용자의 DIDiskQuotaUser 개체를 가져오는 방법에는 여러 가지가 있습니다.

  • 볼륨에 할당량이 있는 모든 사용자의 DIDiskQuotaUser 개체는 컬렉션으로 노출되며 열거할 수 있습니다. DIDiskQuotaUser 개체를 열거하는 방법에 대한 자세한 내용은 DIDiskQuotaUser의 설명 섹션에서 디스크 할당량 사용자 열거를 참조하세요.
  • 새 사용자를 추가하면 AddUser 메서드는 사용자의 DIDiskQuotaUser 개체를 반환합니다.
  • 사용자 이름이 있는 경우 FindUser 메서드는 사용자의 DIDiskQuotaUser 개체를 반환합니다.

이 개체는 스크립팅 및 Microsoft Visual Basic 기반 애플리케이션에서 IDiskQuotaControl 인터페이스의 필수 기능을 사용할 수 있도록 합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버
Windows 2000 Server[데스크톱 앱만]
DLL
Shell32.dll(버전 5.0 이상)

추가 정보

Shell 개체