Platform SDK: Files and I/O

IDiskQuotaUser::GetAccountStatus

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. To determine why a user's name strings are not available, use the status information.

HRESULT GetAccountStatus(
  LPDWORD pdwStatus
);

Parameters

pdwStatus
Pointer to receive the user's account status. The status value can be one of the following.
Value Meaning
DISKQUOTA_USER_ACCOUNT_RESOLVED The SID was resolved to a user account. Names are available through IDiskQuotaUser::GetName.
DISKQUOTA_USER_ABLE 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 The user account was deleted from the domain. Name information is not available.
DISKQUOTA_USER_ACCOUNT_INVALID The user account is invalid. Name information is not available.
DISKQUOTA_USER_ACCOUNT_UNKNOWN The user account is unknown. Name information is not available.
DISKQUOTA_USER_ACCOUNT_UNRESOLVED The SID has not been resolved to a user account.

Return Values

This method returns one of the following values.

Value Meaning
NOERROR Success.
E_INVALIDARG The pdwStatus parameter is NULL.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Dskquota.h.

See Also

File Systems Overview, File System Interfaces, IDiskQuotaUser