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

Статья
08/22/2023

[Начиная с Windows 8 и Windows Server 2012 эта функция устарела. Вместо этого используйте CM_Open_Device_Interface_Key .]

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

Синтаксис

CMAPI CONFIGRET CM_Open_Device_Interface_Key_ExW(
  [in]           LPCWSTR        pszDeviceInterface,
  [in]           REGSAM         samDesired,
  [in]           REGDISPOSITION Disposition,
  [out]          PHKEY          phkDeviceInterface,
  [in]           ULONG          ulFlags,
  [in, optional] HMACHINE       hMachine
);

Параметры

[in] pszDeviceInterface

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

[in] samDesired

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

[in] Disposition

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

RegDisposition_OpenAlways

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

RegDisposition_OpenExisting

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

[out] phkDeviceInterface

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

[in] ulFlags

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

[in, optional] hMachine

Дескриптор компьютера, предоставленный вызывающим абонентом, полученный при предыдущем вызове CM_Connect_Machine.

Примечание Использование этой функции для доступа к удаленным компьютерам не поддерживается начиная с Windows 8 и Windows Server 2012, так как эта функция была удалена.

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

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

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

Требования

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

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

CM_Connect_Machine

SetupDiOpenDeviceInterfaceRegKey

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