función CM_Get_Sibling (cfgmgr32.h)

  • Artículo

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

Consulte también

CM_Get_Child

CM_Get_Sibling_Ex