funzione CM_WaitNoPendingInstallEvents (cfgmgr32.h)

  • Articolo

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
WAIT_OBJECT_0
 Non sono presenti attività di installazione in sospeso.
WAIT_TIMEOUT
 Intervallo di timeout trascorso e le attività di installazione sono ancora in sospeso.
WAIT_FAILED
 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

Vedi anche

CM_WaitNoPendingInstallEvents

Come un'applicazione di installazione del dispositivo verifica la presenza di installazioni di dispositivi in corso