функция CM_Get_Sibling (cfgmgr32.h)
Функция CM_Get_Sibling получает дескриптор экземпляра устройства на следующий одноуровневый узел указанного узла устройства (devnode) в дереве устройств локального компьютера.
Примечание
В Windows Vista и более поздних версиях Windows унифицированная модель свойств устройства использует ключ свойстваDEVPKEY_Device_Siblings для представления одноуровневых элементов устройства. Дополнительные сведения см. в разделе Получение отношений устройств .
Синтаксис
CMAPI CONFIGRET CM_Get_Sibling(
[out] PDEVINST pdnDevInst,
[in] DEVINST dnDevInst,
[in] ULONG ulFlags
);
Параметры
[out] pdnDevInst
Предоставленный вызывающим элементом указатель на дескриптор экземпляра устройства на одноуровневый узел, извлекаемого этой функцией. Полученный дескриптор привязывается к локальному компьютеру.
[in] dnDevInst
Дескриптор экземпляра устройства, предоставленный вызывающим абонентом, привязанный к локальному компьютеру.
[in] ulFlags
Не используется, должно быть равно нулю.
Возвращаемое значение
Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибок с CR_ префиксами, определенных в Cfgmgr32.h.
Комментарии
Чтобы перечислить все дочерние элементы devnode в дереве устройств локального компьютера, сначала вызовите CM_Get_Child , чтобы получить дескриптор первого дочернего узла, а затем вызовите CM_Get_Sibling для получения дескрипторов для остальных дочерних узлов.
Сведения об использовании дескрипторов экземпляров устройства, привязанных к локальному компьютеру, см. в разделе CM_Get_Child.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| Целевая платформа | Универсальное |
| Верхняя часть | cfgmgr32.h (включая Cfgmgr32.h) |
| Библиотека | Cfgmgr32.lib; OneCoreUAP.lib в Windows 10 |
| DLL | CfgMgr32.dll |