RegDisablePredefinedCache function (winreg.h)

Disables handle caching of the predefined registry handle for HKEY_CURRENT_USER for the current process. This function does not work on a remote computer.

To disables handle caching of all predefined registry handles, use the RegDisablePredefinedCacheEx function.

Syntax

LSTATUS RegDisablePredefinedCache();

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

Any access of HKEY_CURRENT_USER after this function is called will result in 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 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header winreg.h (include Windows.h)
Library Advapi32.lib
DLL Advapi32.dll

See also

FormatMessage

Predefined Keys

RegDisablePredefinedCacheEx

Registry Functions