Поделиться через

Функция 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