Compartir a través de

función CM_Get_Sibling_Ex (cfgmgr32.h)

  • Artículo

[A partir de Windows 8 y Windows Server 2012, esta función ha quedado en desuso. Use CM_Get_Sibling en su lugar.]

La función CM_Get_Sibling_Ex obtiene un identificador de instancia de dispositivo para el siguiente nodo relacionado de un nodo de dispositivo especificado, en un árbol de dispositivos local o de una máquina remota.

Sintaxis

CMAPI CONFIGRET CM_Get_Sibling_Ex(
  [out]          PDEVINST pdnDevInst,
  [in]           DEVINST  dnDevInst,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parámetros

[out] pdnDevInst

Puntero proporcionado por el autor de la llamada al identificador de instancia del dispositivo al nodo relacionado que recupera esta función. El identificador recuperado está enlazado al identificador de equipo especificado por hMachine.

[in] dnDevInst

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

[in] ulFlags

No se usa, debe ser cero.

[in, optional] hMachine

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

Nota No se admite el uso de esta función para acceder a máquinas remotas a partir de Windows 8 y Windows Server 2012, ya que esta funcionalidad se ha quitado.
 

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 enumerar todos los elementos secundarios de un nodo de dispositivo en el árbol de dispositivos del equipo local, primero llame a CM_Get_Child_Ex para obtener un identificador al primer nodo secundario y, a continuación, llame a CM_Get_Sibling_Ex para obtener identificadores para el resto de los elementos secundarios.

Para obtener información sobre el uso de identificadores de instancia de dispositivo enlazados a un equipo local o remoto, consulte CM_Get_Child_Ex.

La funcionalidad para acceder a las máquinas remotas se ha quitado en Windows 8 y Windows Server 2012 y sistemas operativos posteriores, por lo que no se puede acceder a las máquinas remotas cuando se ejecutan en estas versiones de Windows.

Requisitos

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

Consulte también

CM_Get_Child_Ex

CM_Get_Sibling