Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
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 FormatMessagefunction with the FORMAT_MESSAGE_FROM_SYSTEM flag set. The message resource is optional, and the call to FormatMessagemight 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