IDiskQuotaUserBatch::Add

[This is preliminary documentation and subject to change.]

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
S_OK Success.
E_POINTER The pUser parameter is NULL.
E_OUTOFMEMORY Insufficient memory.
E_UNEXPECTED An unexpected exception occurred.

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, IDiskQuotaUserBatch