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

Consulte también

SetupDiCreateDeviceInfo

SetupDiEnumDeviceInfo

SetupDiGetWizardPage

SetupDiOpenDeviceInfo