función CM_Open_DevNode_Key (cfgmgr32.h)

La función CM_Open_DevNode_Key abre una clave del Registro para la información de configuración específica del dispositivo.

Sintaxis

CMAPI CONFIGRET CM_Open_DevNode_Key(
  [in]  DEVINST        dnDevNode,
  [in]  REGSAM         samDesired,
  [in]  ULONG          ulHardwareProfile,
  [in]  REGDISPOSITION Disposition,
  [out] PHKEY          phkDevice,
  [in]  ULONG          ulFlags
);

Parámetros

[in] dnDevNode

Identificador de instancia de dispositivo proporcionado por el autor de la llamada que está enlazado al equipo local

[in] samDesired

Acceso de seguridad del Registro necesario para la clave solicitada.

[in] ulHardwareProfile

Perfil de hardware que se va a abrir si ulFlags incluye CM_REGISTRY_CONFIG. Si este valor es cero, se abre la clave del perfil de hardware actual.

[in] Disposition

Especifica cómo se va a abrir la clave del Registro. Puede ser uno de los siguientes valores:

RegDisposition_OpenAlways

Abra la clave si existe. De lo contrario, cree la clave.

RegDisposition_OpenExisting

Abra la clave solo si existe.

[out] phkDevice

Puntero a un HKEY que recibirá la clave abierta cuando se realice correctamente.

[in] ulFlags

Abra las marcas de clave del nodo de dispositivo. Indica el ámbito y el tipo de clave de almacenamiento del Registro que se va a abrir. Puede ser una combinación de las marcas siguientes:

CM_REGISTRY_HARDWARE

Abra la clave de hardware del dispositivo. No combine con CM_REGISTRY_SOFTWARE.

CM_REGISTRY_SOFTWARE

Abra la clave de software del dispositivo. No combine con CM_REGISTRY_HARDWARE.

CM_REGISTRY_USER

Abra la clave por usuario para el usuario actual. No combine con CM_REGISTRY_CONFIG.

CM_REGISTRY_CONFIG

Abra la clave que almacena información de configuración específica del perfil de hardware. No combine con CM_REGISTRY_USER.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve CR_SUCCESS. De lo contrario, devuelve uno de los códigos de error con prefijo CR_ definidos en Cfgmgr32.h.

Comentarios

Cierre el identificador devuelto de esta función mediante una llamada a RegCloseKey.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino	Universal
Encabezado	cfgmgr32.h (incluya Cfgmgr32.h)
Library	Cfgmgr32.lib; OneCoreUAP.lib en Windows 10
Archivo DLL	CfgMgr32.dll

Consulte también

CM_Delete_DevNode_Key

SetupDiOpenDevRegKey