다음을 통해 공유

IDiskQuotaControl::FindUserName 메서드(dskquota.h)

  • 아티클

볼륨 할당량 정보에서 특정 항목을 찾습니다. 사용자의 계정 로그온 이름이 검색 키로 사용됩니다.

구문

HRESULT FindUserName(
  [in]  LPCWSTR         pszLogonName,
  [out] PDISKQUOTA_USER *ppUser
);

매개 변수

[in] pszLogonName

사용자의 계정 로그온 이름에 대한 포인터입니다.

[out] ppUser

할당량 사용자 개체에 대한 IDiskQuotaUser 인터페이스 포인터에 대한 포인터입니다.

반환 값

이 메서드는 파일 시스템 오류 또는 다음 값 중 하나를 반환합니다.

반환 코드 Description
S_OK
 성공.
ERROR_ACCESS_DENIED
 호출자에게 액세스 권한이 부족합니다.
ERROR_INVALID_SID
 사용자의 SID가 잘못되었습니다.
ERROR_NONE_MAPPED
 SID에 사용할 수 있는 매핑이 없습니다.
ERROR_NOT_READY
 DiskQuotaControl 개체가 초기화되지 않았습니다.
E_INVALIDARG
 pUserSid 또는 ppUser 매개 변수는 NULL입니다.
E_OUTOFMEMORY
 메모리가 부족합니다.
E_FAIL
 예기치 않은 파일 시스템 오류가 발생했습니다.
E_UNEXPECTED
 예기치 않은 예외가 발생했습니다.

설명

이 메서드는 할당량 파일에 사용자에 대한 할당량 레코드가 없더라도 사용자 개체를 반환합니다. 이는 자동 사용자 추가 및 기본 할당량 설정의 개념과 일치합니다. 현재 요청된 사용자에 대한 할당량 항목이 없고 디스크 공간을 요청하려는 경우 사용자가 할당량 파일에 추가되는 경우 반환된 사용자 개체에는 경고 임계값과 볼륨 기본 설정과 동일한 하드 할당량 제한이 있습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 dskquota.h
DLL Dskquota.dll

추가 정보

디스크 관리 인터페이스

디스크 할당량

IDiskQuotaControl