Share via


CeRegCreateKeyEx (RAPI) (Windows CE 5.0)

Send Feedback

This function creates the specified key. If the key already exists in the registry, the function opens it.

CeRegCreateKeyEx is a remote application programming interface (RAPI), which enables an application running on a desktop computer to make function calls on a Windows CE–based device.

A Windows CE registry API version of this function exists, and it is called RegCreateKeyEx.

LONGCeRegCreateKeyEx( HKEYhKey, LPCWSTRlpszSubKey, DWORDReserved, LPWSTRlpszClass, DWORDdwOptions, REGSAMsamDesired, LPSECURITY_ATTRIBUTESlpSecurityAttributes, PHKEYphkResult, LPDWORDlpdwDisposition);

Parameters

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

    • HKEY_CLASSES_ROOT
    • HKEY_CURRENT_USER
    • HKEY_LOCAL_MACHINE
    • HKEY_USERS

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

    The key opened or created by the CeRegCreateKeyEx function is a subkey of the key identified by the hKey parameter.

  • lpszSubKey
    [in] Pointer to a null-terminated string specifying the name of a subkey that this function opens or creates. The subkey specified must be a subkey of the key identified by the hKey parameter. This subkey must not begin with the backslash character (\). If the parameter is NULL, then RegCreateKeyEx behaves like RegOpenKey, where it opens the key specified by hKey. In Windows CE, the maximum length of a key name is 255 characters, not including the terminating NULL character. You can also only nest 16 levels of sub-keys in Windows CE.

  • Reserved
    [in] Reserved; set to 0.

  • lpszClass
    [in] Pointer to a null-terminated string that specifies the class (object type) of this key. This parameter is ignored if the key already exists. In Windows CE, the maximum length of a class string is 255 characters, not including the terminating NULL character.

  • dwOptions
    [in] Ignored; set to 0 to ensure compatibility with future versions of Windows CE.

  • samDesired
    [in] Ignored; set to 0 to ensure compatibility with future versions of Windows CE.

  • lpSecurityAttributes
    [in] Set to NULL. Windows CE automatically assigns the key a default security descriptor.

  • phkResult
    [out] Pointer to a variable that receives a handle to the opened or created key. When you no longer need the returned handle, call the CeRegCloseKey function to close it.

  • lpdwDisposition
    [out] Pointer to a variable that receives one of the following disposition values.

    Value Description
    REG_CREATED_NEW_KEY The key did not exist and was created.
    REG_OPENED_EXISTING_KEY The key existed and was simply opened without being changed.

Return Values

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

The key that the CeRegCreateKeyEx function creates has no values. An application can use the CeRegSetValueEx (RAPI) function to set key values.

CeRegCreateKeyEx can create keys under the HKEY_LOCAL_MACHINE and HKEY_USERS registries.

An application can use CeRegCreateKeyEx to temporarily lock a portion of the registry. When the locking process creates a new key, it receives the disposition value REG_CREATED_NEW_KEY, indicating that it owns the lock. Another process attempting to create the same key receives the disposition value REG_OPENED_EXISTING_KEY, indicating that another process already owns the lock.

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Rapi.h.
Link Library: Rapi.lib.

See Also

RAPI Functions | CeRegCloseKey | CeRegDeleteKey (RAPI) | CeRegOpenKeyEx (RAPI) | CeRegSetValueEx (RAPI) | FormatMessage

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.