Partager via


CM_WaitNoPendingInstallEvents, fonction (cfgmgr32.h)

La fonction CMP_WaitNoPendingInstallEvents (CM_WaitNoPendingInstallEvents) attend qu’il n’y ait aucune activité d’installation d’appareil en attente pour le gestionnaire PnP.

Syntaxe

DWORD CM_WaitNoPendingInstallEvents(
  [in] DWORD dwTimeout
);

Paramètres

[in] dwTimeout

Spécifie un intervalle de délai d’attente, en millisecondes.

  • Si dwTimeout est défini sur zéro, la fonction teste s’il existe des événements d’installation en attente et retourne immédiatement.
  • Si dwTimeout est défini sur INFINITE (défini dans Winbase.h), l’intervalle de délai d’attente de la fonction ne s’écoule jamais.
  • Pour toutes les autres valeurs dwTimeout , la fonction retourne lorsque l’intervalle spécifié s’écoule, même s’il reste des événements d’installation en attente.

Valeur retournée

La fonction retourne l’une des valeurs suivantes (définies dans Winbase.h) :

Code de retour Description
WAIT_OBJECT_0
Aucune activité d’installation n’est en attente.
WAIT_TIMEOUT
L’intervalle de délai d’attente s’est écoulé et les activités d’installation sont toujours en attente.
WAIT_FAILED
Échec de la fonction. Appelez GetLastError pour obtenir des informations supplémentaires sur l’erreur.

Remarques

La fonction attend un objet d’événement interne, que le gestionnaire PnP définit lorsqu’il détermine qu’aucune activité d’installation n’est en attente.

Si une valeur de délai d’attente autre que zéro est spécifiée, CMP_WaitNoPendingInstallEvents retourne soit lorsqu’aucun événement d’installation n’est en attente ou lorsque le délai d’attente a expiré, selon la première éventualité.

De nouveaux événements d’installation peuvent se produire à tout moment. Cette fonction indique simplement qu’il n’y a aucune activité d’installation en attente au moment où elle est appelée.

Cette fonction est généralement utilisée par les applications d’installation d’appareil. Pour plus d’informations, consultez Écriture d’une application d’installation d’appareil.

N’appelez pas cette fonction lors du traitement des événements à l’intérieur d’une fonction de rappel initiée par le système qui est censée retourner dans un court laps de temps. Cela inclut le démarrage du service (par exemple dans la fonction de rappel ServiceMain ) ou lors du traitement d’un contrôle dans le gestionnaire de service (par exemple, la fonction de rappel du gestionnaire ) ou à partir de composants d’installation tels que les programmes d’installation de classes ou les co-programmes d’installation.

Pour Windows XP (sans Service Pack installé), cette fonction doit être appelée à partir de la session zéro, avec des privilèges d’administrateur. Pour Windows XP avec Service Pack 1 (SP1) et versions ultérieures de Windows, la fonction peut être appelée à partir de n’importe quelle session, et les privilèges d’administrateur ne sont pas requis.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows XP et versions ultérieures de Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête cfgmgr32.h (inclure Cfgmgr32.h)
Bibliothèque Cfgmgr32.lib
DLL Cfgmgr32.dll

Voir aussi

CM_WaitNoPendingInstallEvents

Comment une application d’installation d’appareil vérifie les installations d’appareils en cours