Funzione SetupDiRegisterCoDeviceInstallers (setupapi.h)
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.
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 |