función CM_Reenumerate_DevNode_Ex (cfgmgr32.h)

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

La función CM_Reenumerate_DevNode_Ex enumera los dispositivos identificados por un nodo de dispositivo especificado y todos sus elementos secundarios.

Sintaxis

CMAPI CONFIGRET CM_Reenumerate_DevNode_Ex(
  [in]           DEVINST  dnDevInst,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parámetros

[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

Marcas proporcionadas por el autor de la llamada que especifican cómo se debe producir la reenumeración. Este parámetro se puede establecer en una combinación de las marcas siguientes, como se indica:

CM_REENUMERATE_ASYNCHRONOUS

La reenumeración debe producirse de forma asincrónica. La llamada a esta función devuelve inmediatamente después de que el administrador de PnP reciba la solicitud de reenumeración. Si se establece esta marca, no se debe establecer también la marca CM_REENUMERATE_SYNCHRONOUS.

CM_REENUMERATE_NORMAL

Especifica el comportamiento predeterminado de la reenumeración, en el que se produce la reenumeración de forma sincrónica. Actualmente, esta marca es equivalente a CM_REENUMERATE_SYNCHRONOUS.

CM_REENUMERATE_RETRY_INSTALLATION

Especifica que Plug and Play debe realizar otro intento de instalar cualquier dispositivo en el subárbol especificado que se ha detectado, pero que aún no están configurados, o se marcan como necesario reinstalación o para los que se debe completar la instalación. Esta marca se puede establecer junto con la marca CM_REENUMERATE_SYNCHRONOUS o la marca CM_REENUMERATE_ASYNCHRONOUS.

Esta marca debe usarse con extrema precaución, ya que puede hacer que el administrador de PnP pida al usuario que realice la instalación de dichos dispositivos. Actualmente, solo los componentes como Administrador de dispositivos y el Asistente para hardware usan esta marca para permitir al usuario reintentar la instalación de dispositivos que ya se han detectado pero que no están instalados actualmente.

CM_REENUMERATE_SYNCHRONOUS

La reenumeración debe producirse de forma sincrónica. La llamada a esta función devuelve cuando se han vuelto aumerar todos los dispositivos del subárbol especificado. Si se establece esta marca, no se debe establecer también la marca CM_REENUMERATE_ASYNCHRONOUS. Esta marca es actualmente equivalente a CM_REENUMERATE_NORMAL.

[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.

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

Si el nodo de dispositivo especificado representa un dispositivo de bus de hardware o software, el administrador de PnP consulta los controladores del dispositivo para obtener una lista de elementos secundarios, intenta configurar e iniciar los dispositivos secundarios que no estaban configurados previamente. El administrador de PnP también inicia la eliminación sorpresa de los dispositivos que ya no están presentes (consulte IRP_MN_SURPRISE_REMOVAL).

Los autores de llamadas de esta función deben tener SeLoadDriverPrivilege. (Los privilegios se describen en la documentación de Microsoft Windows SDK).

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 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

Consulte también

CM_Get_Child_Ex

CM_Reenumerate_DevNode