Platform SDK: Files and I/O

IDiskQuotaUser::GetName

Retrieves the name strings associated with a disk quota user.

HRESULT GetName(
  LPWSTR pszAccountContainer, 
  DWORD cchAccountContainer, 
  LPWSTR pszLogonName, 
  DWORD cchLogonName, 
  LPWSTR pszDisplayName, 
  DWORD cchDisplayName
);

Parameters

pszAccountContainer
Pointer to the buffer to receive the name of the user's account container. This value can be NULL. For Windows NT 4.0 accounts, or for other accounts on without directory service information, this string is simply the domain name. For accounts with directory service information available, this string is a canonical name with the terminating object name removed.
cchAccountContainer
Size of the account container buffer, in characters. Ignored if pszAccountContainer is NULL.
pszLogonName
Pointer to the buffer to receive the name the user specified to log on the computer. This value can be NULL. The format of the name returned depends on whether directory service information is available.
cchLogonName
Size of the logon name buffer, in characters. Ignored if pszLogonName is NULL.
pszDisplayName
Pointer to the buffer to receive the display name for the quota user. This value can be NULL. If the information is not available, the string returned is of zero length.
cchDisplayName
Size of the display-name buffer, in characters. Ignored if pszDisplayName is NULL.

Return Values

This method returns one of the following values.

Value Meaning
NOERROR Success.
ERROR_LOCK_FAILED Failure to obtain an exclusive lock.

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