función CM_Get_Depth (cfgmgr32.h)

La función CM_Get_Depth se usa para obtener la profundidad de un nodo de dispositivo especificado (devnode) dentro del árbol de dispositivos del equipo local.

Sintaxis

CMAPI CONFIGRET CM_Get_Depth(
  [out] PULONG  pulDepth,
  [in]  DEVINST dnDevInst,
  [in]  ULONG   ulFlags
);

Parámetros

[out] pulDepth

Dirección proporcionada por el autor de la llamada de una ubicación para recibir un valor de profundidad, donde cero representa el nodo raíz del árbol del dispositivo, uno representa los elementos secundarios del nodo raíz, etc.

[in] dnDevInst

Identificador de instancia de dispositivo proporcionado por el autor de la llamada que está enlazado al equipo local.

[in] ulFlags

No se usa, debe ser cero.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve CR_SUCCESS. De lo contrario, devuelve uno de los códigos de error CR_ prefijo definidos en Cfgmgr32.h.

Comentarios

Para obtener información sobre el uso de identificadores de instancia de dispositivo enlazados a la máquina local, consulte CM_Get_Child.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino Universal
Encabezado cfgmgr32.h (incluya Cfgmgr32.h)
Library Cfgmgr32.lib; OneCoreUAP.lib en Windows 10
Archivo DLL CfgMgr32.dll

Consulte también

CM_Get_Child

CM_Get_Depth_Ex