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

지정된 사용자의 볼륨에 새 할당량 항목을 추가합니다. 사용자는 SID(보안 식별자)로 식별됩니다.

구문

HRESULT AddUserSid(
  [in]  PSID            pUserSid,
  [in]  DWORD           fNameResolution,
  [out] PDISKQUOTA_USER *ppUser
);

매개 변수

[in] pUserSid

사용자의 SID입니다.

[in] fNameResolution

사용자 계정 정보를 가져오는 방법을 나타냅니다. 볼륨의 할당량 정보는 SID별로 사용자를 식별합니다. 네트워크 도메인 컨트롤러 또는 네트워크에 없는 경우 로컬 컴퓨터에서 사용자 계정 정보(예: 도메인 이름, 계정 이름 및 전체 이름)를 가져와야 합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
DISKQUOTA_USERNAME_RESOLVE_ASYNC 2	사용자 계정 정보를 비동기적으로 해결합니다. AddUserSid는 즉시 반환됩니다. 호출자는 정보를 사용할 수 있을 때 알림을 받으려면 IDiskQuotaEvents 인터페이스를 구현해야 합니다. 이전 요청 중에 정보가 캐시된 경우 개체가 서비스되는 즉시 알림이 발생합니다. 그렇지 않으면 메서드는 네트워크 도메인 컨트롤러에서 정보를 가져온 다음 IDiskQuotaEvents에 알 수 있습니다.
DISKQUOTA_USERNAME_RESOLVE_NONE 0	사용자 계정 정보를 resolve 않습니다.
DISKQUOTA_USERNAME_RESOLVE_SYNC 1	사용자 계정 정보를 동기적으로 해결합니다. AddUserSid 는 정보가 확인되면 를 반환합니다. 정보가 디스크 할당량 SID 캐시에 있으면 즉시 반환됩니다. 그렇지 않으면 메서드는 정보를 찾아야 합니다. 이 작업은 몇 초 정도 걸릴 수 있습니다.

[out] ppUser

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

반환 값

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

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

설명

NTFS 파일 시스템은 사용자가 볼륨에 처음 쓸 때 사용자 할당량 항목을 자동으로 만듭니다. 자동으로 생성되는 항목에는 볼륨에 대한 기본 경고 임계값 및 하드 할당량 제한 값이 할당됩니다. 이 방법을 사용하면 사용자가 볼륨에 정보를 기록하기 전에 사용자 할당량 항목을 만들 수 있습니다. 따라서 볼륨 기본 설정과 다른 경고 임계값 또는 하드 할당량 제한 값을 미리 할당할 수 있습니다.

요구 사항

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

추가 정보

디스크 관리 인터페이스

디스크 할당량

IDiskQuotaControl