Funzione SetupDiInstallClassA (setupapi.h)
La funzione SetupDiInstallClass installa la sezione ClassInstall32 del file INF specificato.
Sintassi
WINSETUPAPI BOOL SetupDiInstallClassA(
[in, optional] HWND hwndParent,
[in] PCSTR InfFileName,
[in] DWORD Flags,
[in, optional] HSPFILEQ FileQueue
);
Parametri
[in, optional] hwndParent
Handle della finestra padre per qualsiasi interfaccia utente usata per installare questa classe. Questo parametro è facoltativo e può essere NULL.
[in] InfFileName
Puntatore a una stringa con terminazione NULL contenente il nome del file INF contenente una sezione INF ClassInstall32.
[in] Flags
Questi flag controllano il processo di installazione. Può essere una combinazione dei seguenti elementi:
DI_NOVCP
Impostare questo flag se Viene fornito FileQueue . DI_NOVCP indica alla funzione SetupInstallFromInfSection (descritta nella documentazione di Microsoft Windows SDK) di non creare una coda di propria e di usare invece la coda fornita dal chiamante. Se questo flag è impostato, i file non vengono copiati solo in coda.
DI_NOBROWSE
Impostare questo flag per disabilitare l'esplorazione se un'operazione di copia non riesce a trovare un file specificato. Se il chiamante fornisce una coda di file, questo flag viene ignorato.
DI_FORCECOPY
Impostare questo flag per copiare sempre i file, anche se sono già presenti nel computer dell'utente. Se il chiamante fornisce una coda di file, questo flag viene ignorato.
DI_QUIETINSTALL
Impostare questo flag per eliminare l'interfaccia utente, a meno che non sia assolutamente necessario. Ad esempio, non visualizzare la finestra di dialogo di avanzamento. Se il chiamante fornisce una coda di file, questo flag viene ignorato.
[in, optional] FileQueue
Se il flag di DI_NOVCP è impostato, questo parametro fornisce un handle a una coda di file in cui le operazioni dei file devono essere accodate ma non sottoposte a commit.
Valore restituito
La funzione restituisce TRUE se ha esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato con una chiamata a GetLastError.
Commenti
Il chiamante di questa funzione deve essere membro del gruppo Administrators.
Questa funzione viene chiamata da un programma di installazione della classe quando installa un dispositivo di una nuova classe di dispositivo.
Per installare una classe di interfaccia o una classe dispositivo, usare SetupDiInstallClassEx.
Nota
L'intestazione setupapi.h definisce SetupDiInstallClass come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
Piattaforma di destinazione | Desktop |
Intestazione | setupapi.h (includere Setupapi.h) |
Libreria | Setupapi.lib |