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