funzione CM_Setup_DevNode (cfgmgr32.h)
La funzione CM_Setup_DevNode riavvia un'istanza del dispositivo che non è in esecuzione perché si è verificato un problema con la configurazione del dispositivo.
Sintassi
CMAPI CONFIGRET CM_Setup_DevNode(
[in] DEVINST dnDevInst,
[in] ULONG ulFlags
);
Parametri
[in] dnDevInst
Handle di istanza del dispositivo associato al sistema locale.
[in] ulFlags
Uno dei valori di flag seguenti:
CM_SETUP_DEVNODE_READY
Riavvia un'istanza del dispositivo che non è in esecuzione a causa di un problema con la configurazione del dispositivo.
CM_SETUP_DEVNODE_RESET (Windows XP e versioni successive di Windows)
Reimposta un'istanza del dispositivo che non ha il flag di stato del dispositivo di riavvio impostato. Il flag di stato del dispositivo di riavvio non viene impostato se un dispositivo viene rimosso chiamando CM_Query_And_Remove_SubTree o CM_Query_And_Remove_SubTree_Ex e specificando il flag di CM_REMOVE_NO_RESTART.
Valore restituito
Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso "CR_" definito in Cfgmgr32.h.
Commenti
Le applicazioni di installazione del dispositivo devono usare la richiesta di DIF_PROPERTYCHANGE per riavviare un dispositivo anziché usare questa funzione. La richiesta di DIF_PROPERTYCHANGE può essere usata per abilitare, disabilitare, riavviare, arrestare o modificare le proprietà di un dispositivo.
Se un'istanza del dispositivo non presenta un problema e viene già avviata, CM_Setup_DevNode restituisce senza modificare lo stato dell'istanza del dispositivo.
Chiamare CM_Get_DevNode_Status o CM_Get_DevNode_Status_Ex per determinare lo stato e il codice di problema per un'istanza del dispositivo.
Requisiti
| Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | cfgmgr32.h (include Cfgmgr32.h) |
| Libreria | Cfgmgr32.lib; OneCoreUAP.lib in Windows 10 |
| DLL | CfgMgr32.dll |