RegDisablePredefinedCacheEx function (winreg.h)

Disables handle caching for all predefined registry handles for the current process.

Syntax

LSTATUS RegDisablePredefinedCacheEx();

Return value

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value is a system error code.

Remarks

This function does not work on a remote computer.

Services that change impersonation should call this function before using any of the predefined handles.

For example, any access of HKEY_CURRENT_USER after this function is called results in open and close operations being performed on HKEY_USERS\SID_of_current_user, or on HKEY_USERS.DEFAULT if the current user's hive is not loaded. For more information on SIDs, see Security Identifiers.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header winreg.h (include Windows.h)
Library Advapi32.lib
DLL Advapi32.dll

See also

FormatMessage

Predefined Keys

Registry Functions