Edit

Share via

IDiskQuotaControl::DeleteUser method (dskquota.h)

  • Article

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

Syntax

HRESULT DeleteUser(
  [in] PDISKQUOTA_USER pUser
);

Parameters

[in] pUser

A pointer to the IDiskQuotaUser interface of the user whose quota record is marked for deletion.

Return value

This method returns a file system error or one of the following values.

Return code Description
S_OK
 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. The NTFS file system 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

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

IDiskQuotaControl