CM_Setup_DevNode, fonction (cfgmgr32.h)
La fonction CM_Setup_DevNode redémarre un appareil instance qui n’est pas en cours d’exécution en raison d’un problème avec la configuration de l’appareil.
Syntaxe
CMAPI CONFIGRET CM_Setup_DevNode(
[in] DEVINST dnDevInst,
[in] ULONG ulFlags
);
Paramètres
[in] dnDevInst
Un instance de périphérique lié au système local.
[in] ulFlags
L’une des valeurs d’indicateur suivantes :
CM_SETUP_DEVNODE_READY
Redémarre un appareil instance qui n’est pas en cours d’exécution en raison d’un problème de configuration de l’appareil.
CM_SETUP_DEVNODE_RESET (Windows XP et versions ultérieures de Windows)
Réinitialise un instance d’appareil pour lequel l’indicateur aucun redémarrage d’appareil status défini. L’indicateur aucun redémarrage de l’appareil status est défini si un appareil est supprimé en appelant CM_Query_And_Remove_SubTree ou CM_Query_And_Remove_SubTree_Ex et en spécifiant l’indicateur de CM_REMOVE_NO_RESTART.
Valeur retournée
Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, il retourne l’un des codes d’erreur avec le préfixe « CR_ » qui sont définis dans Cfgmgr32.h.
Notes
Les applications d’installation d’appareil doivent utiliser la demande DIF_PROPERTYCHANGE pour redémarrer un appareil au lieu d’utiliser cette fonction. La demande DIF_PROPERTYCHANGE peut être utilisée pour activer, désactiver, redémarrer, arrêter ou modifier les propriétés d’un appareil.
Si un instance d’appareil ne rencontre pas de problème et est déjà démarré, CM_Setup_DevNode retourne sans modifier le status de l’appareil instance.
Appelez CM_Get_DevNode_Status ou CM_Get_DevNode_Status_Ex pour déterminer le status et le code du problème pour un instance d’appareil.
Spécifications
| Client minimal pris en charge | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
| Plateforme cible | Universal |
| En-tête | cfgmgr32.h (inclure Cfgmgr32.h) |
| Bibliothèque | Cfgmgr32.lib; OneCoreUAP.lib sur Windows 10 |
| DLL | CfgMgr32.dll |