Función SetupDiRegisterCoDeviceInstallers (setupapi.h)

La función SetupDiRegisterCoDeviceInstallers es el controlador predeterminado para DIF_REGISTER_COINSTALLERS.

Sintaxis

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

Parámetros

[in] DeviceInfoSet

Identificador del conjunto de información del dispositivo que contiene un elemento de información del dispositivo que representa el dispositivo para el que se van a registrar coins instaladores. El conjunto de información del dispositivo no debe contener ningún elemento remoto.

[in] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que especifica el elemento de información del dispositivo en DeviceInfoSet.

Valor devuelto

SetupDiRegisterCoDeviceInstallers devuelve TRUE si la función se realiza correctamente. Si la función devuelve FALSE, llame a GetLastError para obtener información de error extendida.

Comentarios

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

Nota Solo un instalador de clase debe llamar a SetupDiRegisterCoDeviceInstallers y solo en aquellas situaciones en las que el instalador de clase debe realizar operaciones de registro de coinstaladores después de que SetupDiRegisterCoDeviceInstallers complete la operación de registro predeterminada del co-instalador. En tales situaciones, el instalador de clase debe llamar directamente a SetupDiRegisterCoDeviceInstallers cuando el instalador procesa una solicitud de DIF_REGISTER_COINSTALLERS. Para obtener más información sobre cómo llamar al controlador predeterminado, vea Llamar a controladores de código DIF predeterminados.

 

SetupDiRegisterCoDeviceInstallers lee el archivo INF del dispositivo especificado por DeviceInfoData y crea entradas del Registro para registrar los coinstaladores específicos del dispositivo enumerados en el archivo INF. Los coinstaladores se enumeran en una sección INF DDInstall.CoInstallers. Esta función también copia los archivos de los co-instaladores, a menos que se establezca la marca de DI_NOFILECOPY.

Si no hay ningún controlador seleccionado o el dispositivo tiene un archivo INF para Windows 9x o Millennium Edition, esta función no registra ningún co-instalador.

Al registrar un nuevo coins installer específico del dispositivo, se invalida la lista actual del instalador de dispositivos de los co-instaladores. Después de un registro correcto, el Instalador de dispositivos actualiza su lista de co-instaladores.

Esta función solo registra co-instaladores específicos del dispositivo, no instaladores de co-instaladores de clase.

Para obtener más información sobre cómo escribir y registrar coins instaladores específicos del dispositivo, consulte Escritura de un coins installer.

La información del dispositivo especificada por DeviceInfoSet solo debe contener elementos en el equipo local.

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_REGISTER_COINSTALLERS

SetupDiCallClassInstaller