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

Vedi anche

CM_Get_DevNode_Status

CM_Get_DevNode_Status_Ex

CM_Query_And_Remove_SubTree

CM_Query_And_Remove_SubTree_Ex

DIF_PROPERTYCHANGE