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