IDiskQuotaControl::DeleteUser

[This is preliminary documentation and subject to change.]

Removes a user entry from the volume quota information file, if the user's charged quota amount is zero bytes. 

HRESULT DeleteUser(
  PDISKQUOTA_USER pUser
);

Parameters

pUser
Pointer to the IDiskQuotaUser interface of the user whose quota record is marked for deletion.

Return Values

This method returns one of the following values.

Value Meaning
S_OK Success.
E_POINTER The pUser parameter is NULL.
E_FAIL Failure marking entry for deletion.
DQC_E_USER_HAS_FILES The user owns files on the volume.
DQC_E_ACCESS_DENIED The caller has insufficient access rights.

Remarks

This method does not actually remove the quota entry from the volume. It marks the entry for deletion. NTFS performs the actual deletion at a later time. Following a call to IDiskQuotaControl::DeleteUser, the IDiskQuotaUser interface is still active. This method does not delete the user object from memory. To release the user object, call IUnknown::Release.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in dskquota.h.

See Also

File Systems Overview, File System Interfaces, IDiskQuotaControl