Platform SDK: Files and I/O

IDiskQuotaControl::DeleteUser

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 a file system error or one of the following values.

Value Meaning
NOERROR Success.
ERROR_ACCESS_DENIED The caller has insufficient access rights.
ERROR_FILE_EXISTS The user owns files on the volume.
ERROR_NOT_READY The DiskQuotaControl object is not initialized.
E_INVALIDARG The pUser parameter is NULL.
E_OUTOFMEMORY Insufficient memory.
E_FAIL An unexpected file system error occurred.
E_UNEXPECTED An unexpected exception occurred.

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.

Requirements

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

See Also

File Systems Overview, File System Interfaces, IDiskQuotaControl