función CM_Get_Child_Ex (cfgmgr32.h)

Artículo
03/08/2023

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

La función CM_Get_Child_Ex se usa para recuperar un identificador de instancia de dispositivo al primer nodo secundario de un nodo de dispositivo especificado (devnode) en un árbol de dispositivos local o remoto.

Sintaxis

CMAPI CONFIGRET CM_Get_Child_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 la instancia del dispositivo al nodo secundario que recupera esta función. El identificador recuperado está enlazado al identificador de equipo proporcionado por hMachine. Consulte la sección Comentarios .

[in] dnDevInst

Identificador de instancia de dispositivo proporcionado por el autor de la llamada que está enlazado al controlador de máquina proporcionado por hMachine.

[in] ulFlags

No se usa, debe ser cero.

[in, optional] hMachine

Identificador de máquina proporcionado por el autor de la llamada al que está enlazado el identificador de instancia de 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 con prefijo CR_ definidos en Cfgmgr32.h.

Comentarios

Para enumerar todos los elementos secundarios de un nodo de desarrollo en un árbol de dispositivos de una máquina local o remota, 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.

Uso de identificadores de instancia de dispositivo

El identificador de instancia de dispositivo que se usa con las funciones del administrador de configuración de PnP se enlaza a los identificadores de la máquina, como se indica a continuación:

Todos los identificadores de instancia de dispositivo local se enlazan a un identificador de máquina local con valores NULL.
Si usa un identificador de máquina remota para obtener un identificador de instancia de dispositivo, el identificador de instancia de dispositivo remoto resultante se enlaza al identificador de la máquina remota.
Un identificador de instancia de dispositivo solo se puede usar con el identificador de equipo al que está enlazado.
Un identificador de instancia de dispositivo se puede usar con otro identificador de instancia de dispositivo solo si ambos identificadores de instancia de dispositivo están enlazados al mismo identificador de máquina.

Use CM_Connect_Machine para obtener un identificador de máquina remota para su uso con identificadores de instancia de dispositivo remoto.

Para obtener un identificador de instancia de dispositivo local o remoto, realice una de las acciones siguientes.

Use una de las siguientes funciones para recuperar un identificador de instancia de dispositivo enlazado al equipo local: CM_Locate_DevNode, CM_Get_Child, CM_Get_Parent o CM_Get_Sibling.
Use una de las siguientes funciones para recuperar un identificador de instancia de dispositivo enlazado a un equipo local o remoto: CM_Locate_DevNode_Ex, CM_Get_Child_Ex, CM_Get_Parent_Ex o CM_Get_Sibling_Ex.

También puede usar las funciones de instalación de dispositivos para obtener identificadores de instancia de dispositivo. Siga estos pasos:

Obtenga un conjunto de información del dispositivo.
Obtenga una estructura de SP_DEVINFO_DATA para una instancia de dispositivo en el conjunto de información del dispositivo.
Obtenga el identificador de instancia de dispositivo para la instancia de dispositivo del miembro DevInst de la estructura SP_DEVINFO_DATA.
Obtenga el identificador de máquina al que está enlazado el identificador de instancia del dispositivo. Un identificador de instancia de dispositivo obtenido de un conjunto de información de dispositivo está enlazado al identificador de la máquina al que está enlazado el conjunto de información del dispositivo. Obtiene el identificador de equipo de un conjunto de información de dispositivo del miembro RemoteMachineHandle de su estructura SP_DEVINFO_LIST_DETAIL_DATA . (Llame a SetupDiGetDeviceInfoListDetail para obtener una estructura SP_DEVINFO_LIST_DETAIL_DATA).

La funcionalidad para acceder a las máquinas remotas se ha quitado en Windows 8 y sistemas operativos Windows Server 2012 y versiones 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