RegCloseKey (Windows Embedded CE 6.0)

1/6/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 Nkstub.lib
Windows Embedded CE Windows CE 1.0 and later

See Also

Reference

Registry Functions
RegCreateKeyEx
RegDeleteKey
RegOpenKeyEx
RegSetValueEx

Other Resources

State and Notifications Broker