Função SetupDiOpenDevRegKey (setupapi.h)
A função SetupDiOpenDevRegKey abre uma chave do Registro para informações de configuração específicas do dispositivo.
Sintaxe
WINSETUPAPI HKEY SetupDiOpenDevRegKey(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData,
[in] DWORD Scope,
[in] DWORD HwProfile,
[in] DWORD KeyType,
[in] REGSAM samDesired
);
Parâmetros
[in] DeviceInfoSet
Um identificador para o conjunto de informações do dispositivo que contém um elemento de informações do dispositivo que representa o dispositivo para o qual abrir uma chave do Registro.
[in] DeviceInfoData
Um ponteiro para uma estrutura SP_DEVINFO_DATA que especifica o elemento de informações do dispositivo em DeviceInfoSet.
[in] Scope
O escopo da chave do Registro a ser aberta. O escopo determina onde as informações são armazenadas. O escopo pode ser global ou específico para um perfil de hardware. O escopo é especificado por um dos seguintes valores:
DICS_FLAG_GLOBAL
Abra uma chave para armazenar informações de configuração global. Essas informações não são específicas para um perfil de hardware específico. Isso abre uma chave com raiz em HKEY_LOCAL_MACHINE. A chave exata aberta depende do valor do parâmetro KeyType .
DICS_FLAG_CONFIGSPECIFIC
Abra uma chave para armazenar informações de configuração específicas do perfil de hardware. Essa chave está enraizada em um dos branches específicos do perfil de hardware, em vez de HKEY_LOCAL_MACHINE. A chave exata aberta depende do valor do parâmetro KeyType .
[in] HwProfile
Um valor de perfil de hardware, que é definido da seguinte maneira:
- Se Scope for definido como DICS_FLAG_CONFIGSPECIFIC, HwProfile especificará o perfil de hardware da chave a ser aberta.
- Se HwProfile for 0, a chave do perfil de hardware atual será aberta.
- Se Scope for DICS_FLAG_GLOBAL, HwProfile será ignorado.
[in] KeyType
O tipo de chave de armazenamento do Registro a ser aberta, que pode ser um dos seguintes valores:
DIREG_DEV
Abra uma chave de hardware para o dispositivo.
DIREG_DRV
Abra uma chave de software para o dispositivo.
Para obter mais informações sobre as chaves de hardware e software de um dispositivo, consulte Árvores e chaves do Registro para dispositivos e drivers.
[in] samDesired
O acesso de segurança do Registro necessário para a chave solicitada. Para obter informações sobre os valores de acesso de segurança do Registro do tipo REGSAM, consulte a documentação do SDK do Microsoft Windows.
Valor retornado
Se a função for bem-sucedida, ela retornará um identificador para uma chave do Registro aberta em que os dados de configuração privada sobre essa instância de dispositivo podem ser armazenados/recuperados.
Se a função falhar, ela retornará INVALID_HANDLE_VALUE. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Dependendo do valor passado no parâmetro samDesired , pode ser necessário que o chamador dessa função seja membro do grupo Administradores.
Feche o identificador retornado dessa função chamando RegCloseKey.
A instância de dispositivo especificada deve ser registrada antes que essa função seja chamada. No entanto, lembre-se de que o sistema operacional registra automaticamente instâncias de dispositivo PnP. Para obter informações sobre como registrar instâncias de dispositivo não PnP, consulte SetupDiRegisterDeviceInfo.
Requisitos
| Cliente mínimo com suporte | Disponível no Microsoft Windows 2000 e versões posteriores do Windows. |
| Plataforma de Destino | DesktopPara universal, chame CM_Open_DevNode_Key |
| Cabeçalho | setupapi.h (inclua Setupapi.h) |
| Biblioteca | Setupapi.lib |
| DLL | Setupapi.dll |
| Conjunto de APIs | ext-ms-win-setupapi-classinstallers-l1-1-2 (introduzido no Windows 10, versão 10.0.14393) |