RegDisablePredefinedCacheEx Function

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

Syntax

C++
LONG WINAPI RegDisablePredefinedCacheEx(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

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

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

See Also

FormatMessage
Predefined Keys
Registry Functions

Send comments about this topic to Microsoft

Build date: 11/19/2009

Tags :


Page view tracker