Función SetupDiDeleteDeviceInfo (setupapi.h)
La función SetupDiDeleteDeviceInfo elimina un elemento de información del dispositivo de un conjunto de información del dispositivo. Esta función no elimina el dispositivo real.
Sintaxis
WINSETUPAPI BOOL SetupDiDeleteDeviceInfo(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData
);
Parámetros
[in] DeviceInfoSet
Identificador del conjunto de información del dispositivo que contiene el elemento de información del dispositivo que se va a eliminar.
[in] DeviceInfoData
Puntero a una estructura de SP_DEVINFO_DATA que representa el elemento de información del dispositivo en DeviceInfoSet que se va a eliminar.
Valor devuelto
La función devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar con una llamada a GetLastError.
Comentarios
Si el elemento de información del dispositivo especificado está en uso (por ejemplo, mediante una página del asistente), se produce un error en la función. En este caso, una llamada a GetLastError devuelve ERROR_DEVINFO_DATA_LOCKED. Esto sucede si se recupera un identificador para una página del asistente con una llamada a SetupDiGetWizardPage con este elemento de información del dispositivo especificado y la marca DIWP_FLAG_USE_DEVINFO_DATA establecida. Para eliminar este elemento de información del dispositivo, primero debe cerrar el identificador HPROPSHEETPAGE del asistente.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | setupapi.h (incluya Setupapi.h) |
| Library | Setupapi.lib |
| Archivo DLL | Setupapi.dll |