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

Статья
11/20/2024

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

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

Синтаксис

CMAPI CONFIGRET CM_Open_Device_Interface_Key_ExA(
  [in]           LPCSTR         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.

Замечания

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Microsoft Windows 10 и более поздних версиях Windows.
целевая платформа	Настольный
заголовка	cfgmgr32.h (include Cfgmgr32.h)
библиотеки	Cfgmgr32.lib

См. также

CM_Connect_Machine

SetupDiOpenDeviceInterfaceRegKey

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