Функция SetupDiOpenDeviceInterfaceRegKey (setupapi.h)

Функция SetupDiOpenDeviceInterfaceRegKey открывает подраздел реестра, который используется приложениями и драйверами для хранения сведений, относящихся к интерфейсу устройства.

Синтаксис

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

Параметры

[in] DeviceInfoSet

Указатель на набор сведений об устройстве , содержащий интерфейс устройства, для которого открывается подраздел реестра.

[in] DeviceInterfaceData

Указатель на структуру SP_DEVICE_INTERFACE_DATA , указывающую интерфейс устройства. Этот указатель может быть возвращен setupDiCreateDeviceInterface или SetupDiEnumDeviceInterfaces.

Reserved

Зарезервировано. Должен равняться нулю.

[in] samDesired

Запрошенный доступ безопасности реестра к подразделу реестра. Сведения о значениях доступа к системе безопасности реестра типа REGSAM см. в документации по Microsoft Windows SDK.

Возвращаемое значение

SetupDiOpenDeviceInterfaceRegKey возвращает дескриптор открытого раздела реестра. Если функция завершается сбоем, она возвращает INVALID_HANDLE_VALUE. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

В зависимости от значения, передаваемого в параметре samDesired , может потребоваться, чтобы вызывающий объект этой функции был членом группы Администраторы.

Закройте дескриптор, возвращаемый функцией , вызвав RegCloseKey.

Требования

Минимальная версия клиента	Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
Целевая платформа	DesktopДля универсального, вызовите CM_Open_Device_Interface_Key
Верхняя часть	setupapi.h (включая Setupapi.h)
Библиотека	Setupapi.lib
DLL	Setupapi.dll

См. также раздел

SetupDiCreateDeviceInterface

SetupDiCreateDeviceInterfaceRegKey

SetupDiEnumDeviceInterfaces