Share via

IRAPISession::CeRegOpenKeyEx

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method opens the specified registry key on a remote Windows Embedded CE–based device.

Syntax

LONG CeRegOpenKeyEx( 
  HKEY hKey, 
  LPCWSTR lpszSubKey, 
  DWORD ulOptions, 
  REGSAM samDesired, 
  PHKEY phkResult 
);

Parameters

  • hKey
    [in] Handle to a currently open key or any of the following predefined reserved handle values:

    HKEY_CLASSES_ROOT

    HKEY_CURRENT_USER

    HKEY_LOCAL_MACHINE

    HKEY_USERS

    Windows Embedded CE does not support the HKEY_CURRENT_CONFIG, HKEY_PERFORMANCE_DATA, or HKEY_DYN_DATA predefined reserved handle values.

  • lpszSubKey
    [in] Pointer to a null-terminated string containing the name of the subkey to open. If this parameter is NULL or a pointer to an empty string, the function will open a new handle to the key identified by the hKey parameter. In this case, the function will not close the handles previously opened.
  • ulOptions
    [in] Reserved; set to 0.
  • samDesired
    [in] Not supported; set to zero.
  • phkResult
    [out] Pointer to a variable that receives a handle to the opened key. When you no longer need the returned handle, call the IRAPISession::CeRegCloseKey function to close it.

Return Value

ERROR_SUCCESS indicates success. A nonzero error code defined in Winerror.h indicates failure. To get a generic description of the error, call FormatMessage with the FORMAT_MESSAGE_FROM_SYSTEM flag set.

Remarks

Unlike the IRAPISession::CeRegCreateKeyEx function, the IRAPISession::CeRegOpenKeyEx function does not create the specified key if the key does not exist in the registry.

Requirements

Header rapi2.h
Library ole32.lib, rapiuuid.lib
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IRAPISession
IRAPISession::CeRegCloseKey
IRAPISession::CeRegCreateKeyEx