RegDisablePredefinedCache Function

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

C++
LONG WINAPI RegDisablePredefinedCache(void);

Parameters

This function has no parameters.

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

Minimum supported clientWindows 2000 Professional
Minimum supported serverWindows 2000 Server
HeaderWinreg.h (include Windows.h)
LibraryAdvapi32.lib
DLLAdvapi32.dll

See Also

FormatMessage
Predefined Keys
RegDisablePredefinedCacheEx
Registry Functions

Send comments about this topic to Microsoft

Build date: 11/19/2009

Tags :


Page view tracker