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

Confira também

CM_Delete_DevNode_Key

SetupDiOpenDevRegKey