Funzione SetupDiRegisterCoDeviceInstallers (setupapi.h)

Articolo
03/15/2023

La funzione SetupDiRegisterCoDeviceInstallers è il gestore predefinito per DIF_REGISTER_COINSTALLERS.

Sintassi

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

Parametri

[in] DeviceInfoSet

Handle per il set di informazioni sul dispositivo che contiene un elemento informazioni sul dispositivo che rappresenta il dispositivo per cui registrare i co-programmi di installazione. Il set di informazioni sul dispositivo non deve contenere elementi remoti.

[in] DeviceInfoData

Puntatore a una struttura SP_DEVINFO_DATA che specifica l'elemento informazioni sul dispositivo in DeviceInfoSet.

Valore restituito

SetupDiRegisterCoDeviceInstallers restituisceTRUE se la funzione ha esito positivo. Se la funzione restituisce FALSE, chiamare GetLastError per informazioni sugli errori estese.

Commenti

Il chiamante di SetupDiRegisterCoDeviceInstallers deve essere membro del gruppo Administrators.

Nota Solo un programma di installazione di classe deve chiamare SetupDiRegisterCoDeviceInstallers e solo in quelle situazioni in cui il programma di installazione della classe deve eseguire operazioni di registrazione del programma di installazione condivisa dopo che SetupDiRegisterCoDeviceInstallers completa l'operazione di registrazione predefinita del programma di installazione. In tali situazioni, il programma di installazione della classe deve chiamare direttamente SetupDiRegisterCoDeviceInstallers quando il programma di installazione elabora una richiesta di DIF_REGISTER_COINSTALLERS. Per altre informazioni sulla chiamata al gestore predefinito, vedere Chiamata di gestori di codice DIF predefiniti.

SetupDiRegisterCoDeviceInstallers legge il file INF per il dispositivo specificato da DeviceInfoData e crea voci del Registro di sistema per registrare eventuali coinstallatori specifici del dispositivo elencati nel file INF. I coinstallatori sono elencati in una sezione INF DDInstall.CoInstallers. Questa funzione copia anche i file per i co-installer, a meno che non sia impostato il flag di DI_NOFILECOPY.

Se non è selezionato alcun driver o il dispositivo dispone di un file INF per Windows 9x o Millennium Edition, questa funzione non registra alcun programma di installazione.

La registrazione di un nuovo co-programma di installazione specifico del dispositivo invalida l'elenco corrente dei co-programmi di installazione del programma di installazione del dispositivo. Dopo aver completato la registrazione, il Programma di installazione dispositivi aggiorna l'elenco dei co-installer.

Questa funzione registra solo co-installer specifici del dispositivo, non i co-installer di classe.

Per altre informazioni su come scrivere e registrare co-installer specifici del dispositivo, vedere Scrittura di un co-programma di installazione.

Il set di informazioni sul dispositivo specificato da DeviceInfoSet deve contenere solo elementi nel computer locale.

Requisiti

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

Vedi anche

DIF_REGISTER_COINSTALLERS

SetupDiCallClassInstaller

Condividi tramite