The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CM_Open_DevNode_Key function

The CM_Open_DevNode_Key function opens a registry key for device-specific configuration information.

Syntax

C++


CMAPI
CONFIGRET
WINAPI CM_Open_DevNode_Key(
  _In_  DEVINST        dnDevNode,
  _In_  REGSAM         samDesired,
  _In_  ULONG          ulHardwareProfile,
  _In_  REGDISPOSITION Disposition,
  _Out_ PHKEY          phkDevice,
  _In_  ULONG          ulFlags
);

Parameters

dnDevNode [in]

Caller-supplied device instance handle that is bound to the local machine

samDesired [in]

The registry security access that is required for the requested key.

ulHardwareProfile [in]

The hardware profile to open if ulFlags includes CM_REGISTRY_CONFIG. If this value is zero, the key for the current hardware profile is opened.

Disposition [in]

Specifies how the registry key is to be opened. May be one of the following values:

RegDisposition_OpenAlways: Open the key if it exists. Otherwise, create the key.
RegDisposition_OpenExisting: Open the key only if it exists.

phkDevice [out]

Pointer to an HKEY that will receive the opened key upon success.

ulFlags [in]

Open device node key flags. Indicates the scope and type of registry storage key to open. Can be a combination of the following flags:

CM_REGISTRY_HARDWARE: Open the device’s hardware key. Do not combine with CM_REGISTRY_SOFTWARE.
CM_REGISTRY_SOFTWARE: Open the device’s software key. Do not combine with CM_REGISTRY_HARDWARE.
CM_REGISTRY_USER: Open the per-user key for the current user. Do not combine with CM_REGISTRY_CONFIG.
CM_REGISTRY_CONFIG: Open the key that stores hardware profile-specific configuration information. Do not combine with CM_REGISTRY_USER.

Return value

If the operation succeeds, the function returns CR_SUCCESS. Otherwise, it returns one of the CR_-prefixed error codes defined in Cfgmgr32.h.

Remarks

Close the handle returned from this function by calling RegCloseKey.

Requirements

Target platform	Universal
Version	Available in Microsoft Windows 2000 and later versions of Windows.
Header	Cfgmgr32.h (include Cfgmgr32.h)
Library	Cfgmgr32.lib; OneCoreUAP.lib on Windows 10
DLL	CfgMgr32.dll