Funzione SetupDiInstallDriverFiles (setupapi.h)

  • Articolo

La funzione SetupDiInstallDriverFiles è il gestore predefinito per la richiesta di installazione DIF_INSTALLDEVICEFILES .

Sintassi

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

Parametri

[in] DeviceInfoSet

Handle per il set di informazioni sul dispositivo che contiene l'elemento informazioni sul dispositivo che rappresenta il dispositivo per cui installare i file. 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

Se la funzione ha esito positivo, la funzione restituisce TRUE . In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato con una chiamata a GetLastError.

Commenti

Il chiamante di SetupDiInstallDriverFiles deve essere membro del gruppo Administrators se questa funzione viene usata per installare i file. Tuttavia, se questa funzione viene usata per compilare una coda di file, l'appartenenza al gruppo Administrators non è necessaria.

Nota Solo un programma di installazione di classe deve chiamare SetupDiInstallDriverFiles e solo in quelle situazioni in cui il programma di installazione della classe deve eseguire operazioni di installazione dei file driver dopo che SetupDiInstallDriverFiles completa l'operazione di installazione predefinita del file del driver. In tali situazioni, il programma di installazione della classe deve chiamare direttamente SetupDiInstallDriverFiles quando il programma di installazione elabora una richiesta di DIF_INSTALLDEVICEFILES. Per altre informazioni sulla chiamata al gestore predefinito, vedere Chiamata di gestori di codice DIF predefiniti.
 
L'operazione di SetupDiInstallDriverFiles è simile alla funzione SetupDiInstallDevice . Tuttavia, questa funzione esegue solo le operazioni di copia dei file eseguite da SetupDiInstallDevice.

Prima di chiamare questa funzione, è necessario selezionare un driver per il set di informazioni o l'elemento del dispositivo specificato.

Questa funzione elabora le voci CopyFiles, Delfiles e Renfiles nel file INF selezionato.

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

SetupDiCallClassInstaller

SetupDiInstallDevice