Releases the specified key's handle.

LONG RegCloseKey(
    HKEY hKey
);

Parameters

hKey

Handle to the open key to close.

Remarks

This function does not necessarily write information to the registry before returning; it can take as much as several seconds for the cache to flush to the hard disk. If an application must explicitly write registry information to the hard disk, it can use RegFlushKey.

The handle for a specified key should not be used after it is closed, because it is no longer valid. Key handles should not be open any longer than necessary.

Return Values

ERROR_SUCCESS

Success.

A nonzero status code defined in RTWIN32.H.

Failure. For extended error information, see GetLastError.

Requirements

Note

This function operates in the real-time portion of your application.

See Also

RegCreateKeyEx, RegDeleteKey, RegFlushKey, RegOpenKeyEx, RegSetValueEx, iwin32 API, iwin32 Overview