DIDiskQuotaUser 개체

클라이언트가 NTFS 볼륨의 전역 디스크 할당량 설정을 관리할 수 있습니다. 이 개체는 DIDiskQuotaUser 인터페이스의 필수 기능을 스크립팅 및 Microsoft Visual Basic 기반 애플리케이션에 사용할 수 있도록 합니다.

멤버

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

• 메서드
• 속성

메서드

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

메서드	Description
Invalidate	개체의 캐시된 사용자 정보를 지웁니다.

 

속성

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

속성	액세스 유형	설명
AccountContainerName	읽기 전용	사용자 계정 컨테이너의 이름을 가져옵니다.
AccountStatus	읽기 전용	사용자 계정의 상태 가져옵니다.
DisplayName	읽기 전용	사용자의 표시 이름을 가져옵니다.
ID	읽기 전용	사용자를 고유하게 식별하는 ID를 가져옵니다.
LogonName	읽기 전용	사용자의 로그온 계정 이름을 가져옵니다.
QuotaLimit	읽기/쓰기	사용자의 현재 할당량 제한을 설정하거나 가져옵니다.
QuotaLimitText	읽기 전용	사용자의 현재 할당량 한도 를 텍스트 문자열로 가져옵니다.
QuotaThreshold	읽기/쓰기	사용자의 경고 임계값(바이트)을 설정하거나 가져옵니다.
QuotaThresholdText	읽기 전용	사용자의 경고 임계값을 텍스트 문자열로 가져옵니다.
QuotaUsed	읽기 전용	사용자의 현재 디스크 사용량을 바이트 단위로 가져옵니다.
QuotaUsedText	읽기 전용	사용자의 현재 디스크 사용량을 텍스트 문자열로 가져옵니다.

 

설명

DiskQuotaControl 개체에서 관리하는 볼륨의 각 사용자에게는 DIDiskQuotaUser 개체가 연결되어 있습니다. 이 개체를 사용하면 클라이언트가 개별 사용자의 설정을 관리할 수 있습니다. 사용자의 DIDiskQuotaUser 개체를 가져오는 방법에는 여러 가지가 있습니다.

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

디스크 할당량 사용자 열거

볼륨에 할당량이 있는 모든 사용자의 DIDiskQuotaUser 개체는 컬렉션으로 노출됩니다. DiskQuotaControl 개체는 DIDiskQuotaUser 개체의 컬렉션을 열거할 수 있는 표준 열거자 메서드를 내보냅니다. 다음 절차에서는 Microsoft JScript를 사용하여 열거를 수행하는 방법을 보여 줍니다(ECMA 262 언어 사양과 호환됨). Visual Basic 또는 Microsoft VBScript(Visual Basic Scripting Edition)에서 유사한 절차를 사용할 수 있습니다.

1. 새 DiskQuotaControl 개체를 만듭니다.
2. 초기화를 사용하여 초기화합니다.
3. 새 JScript 열거자 개체를 만듭니다.
4. for 루프를 사용하여 DIDiskQuotaUser 개체를 열거합니다. 시작 값을 설정할 필요가 없습니다. 열거자 개체의 moveNext 메서드는 항목 메서드에 다음 DIDiskQuotaUser 개체를 반환하도록 알립니다. 목록 끝에 도달하면 atEnd 메서드가 false 를 반환합니다.
5. 필요에 따라 열거자의 항목 메서드에서 반환된 DIDiskQuotaUser 개체를 사용하여 연결된 사용자의 디스크 할당량 속성 중 하나 이상을 검색하거나 설정합니다.

다음 코드 조각에서는 JScript를 사용하여 DIDiskQuotaUser 개체를 열거하는 방법을 보여 줍니다. EnumUsers 함수에 전달되는 Volume_Label 인수는 "C:\\"와 같은 볼륨 레이블을 포함하는 문자열 값입니다.

function EnumUsers(Volume_Label)
{
    var Volume;
    var QuotaUsers;
    var QuotaUser;

    Volume = new ActiveXObject("Microsoft.DiskQuota.1");
    Volume.Initialize(Volume_Label, 1);

    QuotaUsers = new Enumerator(Volume);
    for (;!Users.atEnd(); Users.moveNext())
    {
       QuotaUser = QuotaUsers.item();

     //Use the QuotaUser object to retrieve or set one or more
     //of the user's disk quota properties
     ...
    }
}

요구 사항

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

추가 정보

Shell 개체