Funzione SetupDiDeleteDeviceInfo (setupapi.h)

  • Articolo

La funzione SetupDiDeleteDeviceInfo elimina un elemento informazioni dispositivo da un set di informazioni sul dispositivo. Questa funzione non elimina il dispositivo effettivo.

Sintassi

WINSETUPAPI BOOL SetupDiDeleteDeviceInfo(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData
);

Parametri

[in] DeviceInfoSet

Handle per il set di informazioni sul dispositivo contenente l'elemento informazioni del dispositivo da eliminare.

[in] DeviceInfoData

Puntatore a una struttura di SP_DEVINFO_DATA che rappresenta l'elemento informazioni del dispositivo in DeviceInfoSet da eliminare.

Valore restituito

La funzione restituisce TRUE se ha esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato con una chiamata a GetLastError.

Commenti

Se l'elemento informazioni sul dispositivo specificato è in uso (ad esempio, da una pagina della procedura guidata), la funzione ha esito negativo. In questo caso, una chiamata a GetLastError restituisce ERROR_DEVINFO_DATA_LOCKED. Ciò accade se viene recuperato un handle in una pagina della procedura guidata con una chiamata a SetupDiGetWizardPage con questo elemento informativo del dispositivo specificato e il set di flag DIWP_FLAG_USE_DEVINFO_DATA. Per eliminare questo elemento di informazioni sul dispositivo, è prima necessario chiudere l'handle HPROPSHEETPAGE della procedura guidata.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione Desktop
Intestazione setupapi.h (includere Setupapi.h)
Libreria Setupapi.lib
DLL Setupapi.dll

Vedi anche

SetupDiCreateDeviceInfo

SetupDiEnumDeviceInfo

SetupDiGetWizardPage

SetupDiOpenDeviceInfo