funzione CM_Disable_DevNode (cfgmgr32.h)

Articolo
02/26/2024

La funzione CM_Disable_DevNode disabilita un dispositivo.

Sintassi

CMAPI CONFIGRET CM_Disable_DevNode(
  [in] DEVINST dnDevInst,
  [in] ULONG   ulFlags
);

Parametri

[in] dnDevInst

Handle dell'istanza del dispositivo associato al computer locale.

[in] ulFlags

Disabilita flag:

CM_DISABLE_UI_NOT_OK

Non visualizzare alcuna interfaccia all'utente se il tentativo di disabilitare il dispositivo non riesce.

CM_DISABLE_PERSIST

Disabilita il dispositivo tra i riavvii.

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_ definiti in Cfgmgr32.h.

Commenti

Per impostazione predefinita, CM_Disable_DevNode disabilita un dispositivo contemporaneamente, ma dopo il riavvio il dispositivo viene nuovamente abilitato. A partire da Windows 10, è possibile specificare il flag di CM_DISABLE_PERSIST per disabilitare il dispositivo tra i riavvii.

Requisiti

Requisito	Valore
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