funzione CM_Setup_DevNode (cfgmgr32.h)

Articolo
08/22/2023

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