funzione CM_WaitNoPendingInstallEvents (cfgmgr32.h)
La funzione CMP_WaitNoPendingInstallEvents (CM_WaitNoPendingInstallEvents) attende fino a quando non sono presenti attività di installazione del dispositivo in sospeso per l'esecuzione del gestore PnP.
Sintassi
DWORD CM_WaitNoPendingInstallEvents(
[in] DWORD dwTimeout
);
Parametri
[in] dwTimeout
Specifica un intervallo di timeout, espresso in millisecondi.
- Se dwTimeout è impostato su zero, la funzione verifica se sono presenti eventi di installazione in sospeso e restituisce immediatamente.
- Se dwTimeout è impostato su INFINITE (definito in Winbase.h), l'intervallo di timeout della funzione non scade mai.
- Per tutti gli altri valori dwTimeout , la funzione restituisce al termine dell'intervallo specificato, anche se sono ancora presenti eventi di installazione in sospeso.
Valore restituito
La funzione restituisce uno dei valori seguenti (definiti in Winbase.h):
| Codice restituito | Descrizione |
|---|---|
|
Non sono presenti attività di installazione in sospeso. |
|
Intervallo di timeout trascorso e le attività di installazione sono ancora in sospeso. |
|
La funzione non è riuscita. Chiamare GetLastError per ulteriori informazioni sull'errore. |
Commenti
La funzione attende un oggetto evento interno, che il gestore PnP imposta quando determina che nessuna attività di installazione è in sospeso.
Se viene specificato un valore di timeout diverso da zero, CMP_WaitNoPendingInstallEvents restituirà quando non sono in sospeso eventi di installazione o quando il periodo di timeout è scaduto, a prescindere dal primo.
I nuovi eventi di installazione possono verificarsi in qualsiasi momento. Questa funzione indica solo che non sono presenti attività di installazione in sospeso al momento della chiamata.
Questa funzione viene in genere usata dalle applicazioni di installazione del dispositivo. Per altre informazioni, vedere Scrittura di un'applicazione di installazione del dispositivo.
Non chiamare questa funzione durante l'elaborazione di eventi all'interno di una funzione di callback avviata dal sistema che dovrebbe restituire entro un breve periodo di tempo. Ciò include l'avvio del servizio ( ad esempio nella funzione di callback ServiceMain ) o durante l'elaborazione di qualsiasi controllo nel gestore del servizio (ad esempio, la funzione di callback del gestore ) o da componenti di installazione come programmi di installazione di classe o co-installer.
Per Windows XP (senza Service Pack installato), questa funzione deve essere chiamata da zero sessione, con privilegi di amministratore. Per Windows XP con Service Pack 1 (SP1) e versioni successive di Windows, la funzione può essere chiamata da qualsiasi sessione e i privilegi di amministratore non sono necessari.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows XP e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | cfgmgr32.h (include Cfgmgr32.h) |
| Libreria | Cfgmgr32.lib |
| DLL | Cfgmgr32.dll |