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

Confira também

SetupDiCreateDevRegKey

SetupDiCreateDeviceInfo

SetupDiGetHwProfileList

SetupDiRegisterDeviceInfo