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