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

Статья
02/23/2024

Функция CM_Open_DevNode_Key открывает раздел реестра для сведений о конфигурации устройства.

Синтаксис

CMAPI CONFIGRET CM_Open_DevNode_Key(
  [in]  DEVINST        dnDevNode,
  [in]  REGSAM         samDesired,
  [in]  ULONG          ulHardwareProfile,
  [in]  REGDISPOSITION Disposition,
  [out] PHKEY          phkDevice,
  [in]  ULONG          ulFlags
);

Параметры

[in] dnDevNode

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

[in] samDesired

Доступ к системе безопасности реестра, необходимый для запрошенного раздела.

[in] ulHardwareProfile

Профиль оборудования, который нужно открыть, если ulFlags включает CM_REGISTRY_CONFIG. Если это значение равно нулю, открывается ключ для текущего профиля оборудования.

[in] Disposition

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

RegDisposition_OpenAlways

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

RegDisposition_OpenExisting

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

[out] phkDevice

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

[in] ulFlags

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

CM_REGISTRY_HARDWARE

Откройте аппаратный ключ устройства. Не сочетайте с CM_REGISTRY_SOFTWARE.

CM_REGISTRY_SOFTWARE

Откройте программный ключ устройства. Не сочетайте с CM_REGISTRY_HARDWARE.

CM_REGISTRY_USER

Откройте ключ для текущего пользователя. Не сочетайте с CM_REGISTRY_CONFIG.

CM_REGISTRY_CONFIG

Откройте ключ, в котором хранятся сведения о конфигурации для конкретного профиля оборудования. Не сочетайте с CM_REGISTRY_USER.

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

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

Требования

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

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

CM_Delete_DevNode_Key

SetupDiOpenDevRegKey