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