função CM_Open_DevNode_Key (cfgmgr32.h)
A função CM_Open_DevNode_Key abre uma chave do Registro para informações de configuração específicas do dispositivo.
Sintaxe
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 instância de dispositivo fornecido pelo chamador associado ao computador local
[in] samDesired
O acesso de segurança do Registro necessário para a chave solicitada.
[in] ulHardwareProfile
O perfil de hardware a ser aberto se ulFlags incluir CM_REGISTRY_CONFIG. Se esse valor for zero, a chave do perfil de hardware atual será aberta.
[in] Disposition
Especifica como a chave do Registro deve ser aberta. Pode ser um dos seguintes valores:
RegDisposition_OpenAlways
Abra a chave se ela existir. Caso contrário, crie a chave.
RegDisposition_OpenExisting
Abra a chave somente se ela existir.
[out] phkDevice
Ponteiro para um HKEY que receberá a chave aberta após o sucesso.
[in] ulFlags
Abra sinalizadores de chave de nó do dispositivo. Indica o escopo e o tipo de chave de armazenamento do Registro a ser aberta. Pode ser uma combinação dos seguintes sinalizadores:
CM_REGISTRY_HARDWARE
Abra a chave de hardware do dispositivo. Não combine com CM_REGISTRY_SOFTWARE.
CM_REGISTRY_SOFTWARE
Abra a chave de software do dispositivo. Não combine com CM_REGISTRY_HARDWARE.
CM_REGISTRY_USER
Abra a chave por usuário para o usuário atual. Não combine com CM_REGISTRY_CONFIG.
CM_REGISTRY_CONFIG
Abra a chave que armazena informações de configuração específicas do perfil de hardware. Não combine com CM_REGISTRY_USER.
Retornar valor
Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, ele retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.
Comentários
Feche o identificador retornado dessa função chamando RegCloseKey.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows 2000 e versões posteriores do Windows. |
| Plataforma de Destino | Universal |
| Cabeçalho | cfgmgr32.h (inclua Cfgmgr32.h) |
| Biblioteca | Cfgmgr32.lib; OneCoreUAP.lib no Windows 10 |
| DLL | CfgMgr32.dll |