CM_Setup_DevNode, fonction (cfgmgr32.h)

Article
08/22/2023

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