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 |