функция CM_Get_DevNode_Registry_PropertyW (cfgmgr32.h)
Функция CM_Get_DevNode_Registry_Property извлекает указанное свойство устройства из реестра.
Синтаксис
CMAPI CONFIGRET CM_Get_DevNode_Registry_PropertyW(
[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 |