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 |