función CM_WaitNoPendingInstallEvents (cfgmgr32.h)
La función CMP_WaitNoPendingInstallEvents (CM_WaitNoPendingInstallEvents) espera hasta que no haya actividades de instalación de dispositivos pendientes para que el administrador de PnP realice.
Sintaxis
DWORD CM_WaitNoPendingInstallEvents(
[in] DWORD dwTimeout
);
Parámetros
[in] dwTimeout
Especifica un intervalo de tiempo de espera, en milisegundos.
- Si dwTimeout se establece en cero, la función comprueba si hay eventos de instalación pendientes y devuelve inmediatamente.
- Si dwTimeout se establece en INFINITE (definido en Winbase.h), el intervalo de tiempo de espera de la función nunca transcurre.
- Para todos los demás valores dwTimeout , la función devuelve cuando transcurre el intervalo especificado, incluso si todavía hay eventos de instalación pendientes.
Valor devuelto
La función devuelve uno de los siguientes valores (definidos en Winbase.h):
| Código devuelto | Descripción |
|---|---|
|
No hay actividades de instalación pendientes. |
|
El intervalo de tiempo de espera transcurrido y las actividades de instalación siguen pendientes. |
|
Error en la función. Llame a GetLastError para obtener información adicional sobre el error. |
Comentarios
La función espera un objeto de evento interno, que el administrador de PnP establece cuando determina que no hay ninguna actividad de instalación pendiente.
Si se especifica un valor de tiempo de espera distinto de cero, CMP_WaitNoPendingInstallEvents devolverá cuando no haya eventos de instalación pendientes o cuando haya expirado el período de tiempo de espera, lo que ocurra primero.
Los nuevos eventos de instalación pueden producirse en cualquier momento. Esta función solo indica que no hay actividades de instalación pendientes en el momento en que se llama.
Normalmente, las aplicaciones de instalación de dispositivos usan esta función. Para obtener más información, consulte Escritura de una aplicación de instalación de dispositivos.
No llame a esta función mientras procesa eventos dentro de una función de devolución de llamada iniciada por el sistema que se espera que devuelva dentro de un breve período de tiempo. Esto incluye el inicio del servicio (por ejemplo, en la función de devolución de llamada ServiceMain ) o durante el procesamiento de cualquier control en el controlador de servicio (por ejemplo, la función de devolución de llamada Handler ), o desde componentes de instalación como instaladores de clase o coinstaladores.
Para Windows XP (sin ningún Service Pack instalado), se debe llamar a esta función desde la sesión cero, con privilegios de administrador. Para Windows XP con Service Pack 1 (SP1) y versiones posteriores de Windows, no se puede llamar a la función desde cualquier sesión y no se requieren privilegios de administrador.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows XP y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | cfgmgr32.h (incluya Cfgmgr32.h) |
| Library | Cfgmgr32.lib |
| Archivo DLL | Cfgmgr32.dll |