Platform SDK: Files and I/O

IDiskQuotaUserBatch::Add

Adds an IDiskQuotaUser pointer to the batch list. This method calls AddRef on the pUser interface pointer. Release is automatically called on each contained IDiskQuotaUser interface pointer when the batch object is destroyed.

When setting values on a quota user object in preparation for batch processing, specify FALSE for the fWriteThrough parameter in the IDiskQuotaUser::SetQuotaLimit and IDiskQuotaUser::SetQuotaThreshold methods. This stores the values in memory without writing to disk. To write the changes to disk, call the IDiskQuotaUserBatch::FlushToDisk method.

HRESULT Add(
  PDISKQUOTA_USER pUser
);

Parameters

pUser
Pointer to the quota user object's IDiskQuotaUser interface.

Return Values

This method returns one of the following values.

Value Meaning
NOERROR Success.
E_INVALIDARG The pUser parameter is NULL.
E_OUTOFMEMORY Insufficient memory.
E_UNEXPECTED An unexpected exception occurred.

Requirements

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

See Also

File Systems Overview, File System Interfaces, IDiskQuotaUserBatch