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

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

  • Статья

Функция CM_Get_DevNode_Registry_Property извлекает указанное свойство устройства из реестра.

Синтаксис

CMAPI CONFIGRET CM_Get_DevNode_Registry_PropertyA(
  [in]            DEVINST dnDevInst,
  [in]            ULONG   ulProperty,
  [out, optional] PULONG  pulRegDataType,
  [out, optional] PVOID   Buffer,
  [in, out]       PULONG  pulLength,
  [in]            ULONG   ulFlags
);

Параметры

[in] dnDevInst

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

[in] ulProperty

Постоянное значение CM_DRP_ с префиксом, определяющее свойство устройства, которое должно быть получено из реестра. Эти константы определены в Cfgmgr32.h.

[out, optional] pulRegDataType

Необязательный параметр может иметь значение NULL. Указатель на расположение, которое получает тип данных реестра, указанный в виде константы с REG_ префиксом, определенной в Winnt.h.

[out, optional] Buffer

Необязательный параметр может иметь значение NULL. Указатель на буфер, предоставленный вызывающим объектом, который получает запрошенное свойство устройства. Если это значение равно NULL, функция предоставляет только длину запрошенных данных в адресе, на который указывает pulLength.

[in, out] pulLength

Указатель на переменную ULONG, в которой функция сохраняет длину запрошенного свойства устройства в байтах.

Если для параметра Buffer задано значение NULL, переменная ULONG должна иметь нулевое значение.

Если для параметра Buffer не задано значение NULL, для переменной ULONG необходимо задать длину буфера, предоставленного вызывающим объектом, в байтах.

[in] ulFlags

Не используется, должно быть равно нулю.

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

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

Комментарии

Сведения об использовании дескрипторов экземпляров устройства, привязанных к локальному компьютеру, см. в разделе CM_Get_Child.

Требования

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

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

CM_Get_Child
CM_Set_DevNode_Registry_Property
SetupDiGetDeviceRegistryProperty