RegCloseKey
A version of this page is also available for
4/8/2010
This function releases the handle of the specified key.
A remote application interface (RAPI) version of this function exists called CeRegCloseKey (RAPI).
Syntax
LONG RegCloseKey(
HKEY hKey
);
Parameters
- hKey
[in] Handle to the open key to close.
Return Value
ERROR_SUCCESS indicates success. A nonzero value indicates failure. To get a generic description of the error, call the FormatMessage function with the FORMAT_MESSAGE_FROM_SYSTEM flag set. The message resource is optional, and the call to FormatMessage might fail.
Remarks
The handle to the specified key cannot be used after it has been closed because it is no longer valid. Do not leave key handles open any longer than necessary.
This function always writes information to the registry before returning, eliminating the need to flush keys in the Windows Embedded CE registry.
Requirements
| Header | winreg.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
Registry Functions
RegCreateKeyEx
RegDeleteKey
RegOpenKeyEx
RegSetValueEx