IDiskQuotaControl::FindUserName 메서드(dskquota.h)
볼륨 할당량 정보에서 특정 항목을 찾습니다. 사용자의 계정 로그온 이름이 검색 키로 사용됩니다.
구문
HRESULT FindUserName(
[in] LPCWSTR pszLogonName,
[out] PDISKQUOTA_USER *ppUser
);
매개 변수
[in] pszLogonName
사용자의 계정 로그온 이름에 대한 포인터입니다.
[out] ppUser
할당량 사용자 개체에 대한 IDiskQuotaUser 인터페이스 포인터에 대한 포인터입니다.
반환 값
이 메서드는 파일 시스템 오류 또는 다음 값 중 하나를 반환합니다.
| 반환 코드 | Description |
|---|---|
|
성공. |
|
호출자에게 액세스 권한이 부족합니다. |
|
사용자의 SID가 잘못되었습니다. |
|
SID에 사용할 수 있는 매핑이 없습니다. |
|
DiskQuotaControl 개체가 초기화되지 않았습니다. |
|
pUserSid 또는 ppUser 매개 변수는 NULL입니다. |
|
메모리가 부족합니다. |
|
예기치 않은 파일 시스템 오류가 발생했습니다. |
|
예기치 않은 예외가 발생했습니다. |
설명
이 메서드는 할당량 파일에 사용자에 대한 할당량 레코드가 없더라도 사용자 개체를 반환합니다. 이는 자동 사용자 추가 및 기본 할당량 설정의 개념과 일치합니다. 현재 요청된 사용자에 대한 할당량 항목이 없고 디스크 공간을 요청하려는 경우 사용자가 할당량 파일에 추가되는 경우 반환된 사용자 개체에는 경고 임계값과 볼륨 기본 설정과 동일한 하드 할당량 제한이 있습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | dskquota.h |
| DLL | Dskquota.dll |