функция CM_Open_Device_Interface_KeyA (cfgmgr32.h)

Статья
08/22/2023

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

Синтаксис

CMAPI CONFIGRET CM_Open_Device_Interface_KeyA(
  [in]  LPCSTR         pszDeviceInterface,
  [in]  REGSAM         samDesired,
  [in]  REGDISPOSITION Disposition,
  [out] PHKEY          phkDeviceInterface,
  [in]  ULONG          ulFlags
);

Параметры

[in] pszDeviceInterface

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

[in] samDesired

Запрошенный доступ по безопасности реестра к подразделу реестра.

[in] Disposition

Указывает способ открытия раздела реестра. Может иметь одно из следующих значений:

RegDisposition_OpenAlways

Откройте ключ, если он существует. В противном случае создайте ключ.

RegDisposition_OpenExisting

Открывайте ключ только в том случае, если он существует.

[out] phkDeviceInterface

Указатель на ключ HKEY, который получит открытый ключ после успешного выполнения.

[in] ulFlags

Зарезервировано. Необходимо задать нулевое значение.

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

Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибок с CR_ префиксами, определенных в Cfgmgr32.h.

Заголовок cfgmgr32.h определяет CM_Open_Device_Interface_Key как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Microsoft Windows Vista и более поздних версиях Windows.
Целевая платформа	Универсальное
Верхняя часть	cfgmgr32.h (включая Cfgmgr32.h)
Библиотека	Cfgmgr32.lib

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

SetupDiOpenDeviceInterfaceRegKey

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