IDiskQuotaControl::CreateEnumUsers 메서드(dskquota.h)
볼륨에서 할당량 사용자를 열거하기 위한 열거자 개체를 만듭니다. 새로 만든 개체는 IEnumDiskQuotaUsers 인터페이스를 구현합니다.
구문
HRESULT CreateEnumUsers(
[in] PSID *rgpUserSids,
[in] DWORD cpSids,
[in] DWORD fNameResolution,
[out] PENUM_DISKQUOTA_USERS *ppEnum
);
매개 변수
[in] rgpUserSids
열거형에 포함할 사용자 개체를 나타내는 SID(보안 식별자) 포인터의 배열입니다. 이 값이 NULL이면 모든 사용자 항목이 열거됩니다.
[in] cpSids
rgpUserSids 배열의 항목 수입니다. rgpUserSids가 NULL이면 무시됩니다.
[in] fNameResolution
사용자 계정 정보를 가져오는 방법을 나타냅니다. 볼륨의 할당량 정보는 SID별로 사용자를 식별합니다. 네트워크 도메인 컨트롤러 또는 네트워크에 없는 경우 로컬 컴퓨터에서 사용자 계정 정보(예: 도메인 이름, 계정 이름 및 전체 이름)를 가져와야 합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
사용자 계정 정보를 비동기적으로 확인합니다. IEnumDiskQuotaUsers::Next 메서드는 즉시 반환됩니다. 호출자는 정보를 사용할 수 있을 때 알림을 받으려면 IDiskQuotaEvents 인터페이스를 구현해야 합니다. 이전 요청 중에 정보가 캐시된 경우 개체가 서비스되는 즉시 알림이 발생합니다. 그렇지 않으면 메서드는 네트워크 도메인 컨트롤러에서 정보를 가져온 다음 IDiskQuotaEvents에 알 수 있습니다. |
|
사용자 계정 정보를 resolve 않습니다. |
|
동기적으로 사용자 계정 정보를 확인합니다. IEnumDiskQuotaUsers::Next 메서드는 정보가 확인되면 를 반환합니다. 디스크 할당량 SID 캐시에 정보가 있으면 즉시 반환됩니다. 그렇지 않으면 메서드는 정보를 찾아야 합니다. 이 작업은 몇 초 정도 걸릴 수 있습니다. |
[out] ppEnum
IEnumDiskQuotaUsers 열거자에 대한 포인터에 대한 포인터입니다.
반환 값
이 메서드는 다음 값 중 하나를 반환합니다.
| 반환 코드 | Description |
|---|---|
|
성공. |
|
호출자에게 액세스 권한이 부족합니다. |
|
DiskQuotaControl 개체가 초기화되지 않았습니다. |
|
ppEnum 매개 변수는 NULL입니다. |
|
메모리가 부족합니다. |
|
예기치 않은 예외가 발생했습니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | dskquota.h |
| DLL | Dskquota.dll |