IDiskQuotaControl::InvalidateSidNameCache method (dskquota.h)

Invalidates the contents of the system's SID-to-name cache so subsequent requests for new user objects (IEnumDiskQuotaUsers::Next, IDiskQuotaControl::FindUserSid, and IDiskQuotaControl::FindUserName) must obtain user names from the domain controller. As names are obtained, they are cached.

Syntax

HRESULT InvalidateSidNameCache();

Return value

This method returns one of the following values.

Return code Description
S_OK
Success.
ERROR_NOT_READY
The DiskQuotaControl object is not initialized.
E_OUTOFMEMORY
Insufficient memory.
E_UNEXPECTED
An unexpected exception occurred.
E_FAIL
The SID-to-name cache is not available or could not be exclusively locked.

Remarks

In general, there is no reason to call this method. It is included to provide a method for programmatically refreshing the entire SID-to-name cache.

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