Edit

Share via

IDiskQuotaUser::GetAccountStatus method (dskquota.h)

  • Article

Retrieves the status of the user object's account. User information is identified in the quota system by user security identifier (SID). This SID must resolve to a user account for the user's account name information to be retrieved.

Syntax

HRESULT GetAccountStatus(
  [out] LPDWORD pdwStatus
);

Parameters

[out] pdwStatus

The user's account status. The status value can be one of the following.

Value Meaning
DISKQUOTA_USER_ACCOUNT_RESOLVED
0
 The SID was resolved to a user account. Names are available through IDiskQuotaUser::GetName.
DISKQUOTA_USER_ACCOUNT_UNAVAILABLE
1
 The user account is unavailable at this time. The network domain controller may not be available. Name information is not available.
DISKQUOTA_USER_ACCOUNT_DELETED
2
 The user account was deleted from the domain. Name information is not available.
DISKQUOTA_USER_ACCOUNT_INVALID
3
 The user account is invalid. Name information is not available.
DISKQUOTA_USER_ACCOUNT_UNKNOWN
4
 The user account is unknown. Name information is not available.
DISKQUOTA_USER_ACCOUNT_UNRESOLVED
5
 The SID has not been resolved to a user account.

Return value

This method returns one of the following values.

Return code Description
S_OK
 Success.
E_INVALIDARG
 The pdwStatus parameter is NULL.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header dskquota.h
DLL Dskquota.dll

See also

Disk Management Interfaces

Disk Quotas

IDiskQuotaUser