Compartir a través de

Función SetupDiUnremoveDevice (setupapi.h)

  • Artículo

La función SetupDiUnremoveDevice es el controlador predeterminado para la solicitud de instalación de DIF_UNREMOVE .

Sintaxis

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

Parámetros

[in] DeviceInfoSet

Identificador de un conjunto de información de dispositivo para el sistema local que contiene un elemento de información del dispositivo que representa un dispositivo que se va a restaurar y reiniciar.

[in, out] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que especifica el elemento de información del dispositivo en DeviceInfoSet. Se trata de un parámetro IN-OUT porque DeviceInfoData.DevInst puede actualizarse con un nuevo valor de identificador en la devolución.

Valor devuelto

La función devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar mediante una llamada a GetLastError.

Comentarios

SetupDiUnremoveDevice restaura un dispositivo a un perfil de hardware. Esta función inicia el dispositivo, si es posible, o establece una marca en los parámetros de instalación del dispositivo que finalmente hace que se le pida al usuario que apague el sistema.

Nota Solo un instalador de clase debe llamar a SetupDiUnremoveDevice y solo en aquellas situaciones en las que el instalador de clase debe realizar operaciones de desremove del dispositivo después de que SetupDiUnremoveDevice complete la operación predeterminada de deshacer el dispositivo. En tales situaciones, el instalador de clase debe llamar directamente a SetupDiUnremoveDevice cuando el instalador procesa una solicitud de DIF_UNREMOVE. Para obtener más información sobre cómo llamar al controlador predeterminado, vea Llamar a controladores de código DIF predeterminados.
 
El dispositivo que se está restaurando debe tener parámetros de instalación de clase para DIF_UNREMOVE o se produce un error en la función y GetLastError devuelve ERROR_NO_CLASSINSTALL_PARAMS.

DeviceInfoSet solo debe contener elementos en el equipo local.

El autor de la llamada de SetupDiUnremoveDevice debe ser miembro del grupo Administradores.

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

Consulte también

DIF_UNREMOVE

SP_DEVINFO_DATA

SetupDiRemoveDevice