Função SetupDiOpenDeviceInterfaceRegKey (setupapi.h)

A função SetupDiOpenDeviceInterfaceRegKey abre a subchave do Registro usada por aplicativos e drivers para armazenar informações específicas de uma interface do dispositivo.

Sintaxe

WINSETUPAPI HKEY SetupDiOpenDeviceInterfaceRegKey(
  [in] HDEVINFO                  DeviceInfoSet,
  [in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
       DWORD                     Reserved,
  [in] REGSAM                    samDesired
);

Parâmetros

[in] DeviceInfoSet

Um ponteiro para um conjunto de informações do dispositivo que contém a interface do dispositivo para a qual abrir uma subchave do Registro.

[in] DeviceInterfaceData

Um ponteiro para uma estrutura SP_DEVICE_INTERFACE_DATA que especifica a interface do dispositivo. Esse ponteiro pode ser retornado por SetupDiCreateDeviceInterface ou SetupDiEnumDeviceInterfaces.

Reserved

Reservado. Deve ser zero.

[in] samDesired

O acesso de segurança do Registro solicitado à subchave do Registro. Para obter informações sobre valores de acesso de segurança do Registro do tipo REGSAM, consulte a documentação do SDK do Microsoft Windows.

Valor retornado

SetupDiOpenDeviceInterfaceRegKey retorna um identificador para a chave do Registro aberta. 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 por função chamando RegCloseKey.

Requisitos

Confira também

SetupDiCreateDeviceInterface

SetupDiCreateDeviceInterfaceRegKey

SetupDiEnumDeviceInterfaces