función CM_Get_Sibling (cfgmgr32.h)
La función CM_Get_Sibling obtiene un identificador de instancia de dispositivo para el siguiente nodo relacionado de un nodo de dispositivo especificado (devnode) en el árbol de dispositivos del equipo local.
Nota
En Windows Vista y versiones posteriores de Windows, el modelo de propiedades de dispositivo unificado usa la clave de propiedadDEVPKEY_Device_Siblings para representar los elementos del mismo nivel del dispositivo. Consulte Recuperación de relaciones de dispositivos para obtener más información.
Sintaxis
CMAPI CONFIGRET CM_Get_Sibling(
[out] PDEVINST pdnDevInst,
[in] DEVINST dnDevInst,
[in] ULONG ulFlags
);
Parámetros
[out] pdnDevInst
Puntero proporcionado por el autor de la llamada al identificador de la instancia del dispositivo al nodo relacionado que recupera esta función. El identificador recuperado está enlazado al equipo local.
[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 con prefijo CR_ definidos en Cfgmgr32.h.
Comentarios
Para enumerar todos los elementos secundarios de un nodo de desarrollo en el árbol de dispositivos del equipo local, primero llame a CM_Get_Child para obtener un identificador al primer nodo secundario y, a continuación, llame a CM_Get_Sibling para obtener identificadores para el resto de los elementos secundarios.
Para obtener información sobre el uso de identificadores de instancia de dispositivo enlazados al equipo 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 |