функция 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.

Требования

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

CM_Get_Child

CM_Get_Depth_Ex