Funzione SetupDiInstallClassExA (setupapi.h)
La funzione SetupDiInstallClassEx installa un programma di installazione della classe o una classe di interfaccia.
Sintassi
WINSETUPAPI BOOL SetupDiInstallClassExA(
[in, optional] HWND hwndParent,
[in, optional] PCSTR InfFileName,
[in] DWORD Flags,
[in, optional] HSPFILEQ FileQueue,
[in, optional] const GUID *InterfaceClassGuid,
PVOID Reserved1,
PVOID Reserved2
);
Parametri
[in, optional] hwndParent
Handle della finestra padre per qualsiasi interfaccia utente utilizzata per installare questa classe. Questo parametro è facoltativo e può essere NULL.
[in, optional] InfFileName
Puntatore a una stringa con terminazione NULL contenente il nome di un file INF. Questo parametro è facoltativo e può essere NULL. Se questa funzione viene usata per installare un programma di installazione della classe, il file INF contiene un sezione INF ClassInstall32 e questo parametro non deve essere NULL.
Se questa funzione viene usata per installare una classe di interfaccia, il file INF contiene una sezione INF InterfaceInstall32
[in] Flags
Valore di tipo DWORD che controlla il processo di installazione. i flag possono essere pari a zero o a or bit per bit dei valori seguenti:
DI_NOVCP
Impostare questo flag se viene fornito FileQueue.
DI_NOVCP indica alla funzione di
Se questo flag è impostato, i file non vengono copiati semplicemente in coda.
Per altre informazioni sulla funzione SetupInstallFromInfSection, vedere la documentazione di Microsoft Windows SDK.
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 stato. Se il chiamante fornisce una coda di file, questo flag viene ignorato.
[in, optional] FileQueue
Se il flag DI_NOVCP è impostato, questo parametro fornisce un handle a una coda di file in cui le operazioni sui file devono essere accodate ma non sottoposte a commit.
[in, optional] InterfaceClassGuid
Puntatore a un GUID che identifica la classe di interfaccia da installare. Questo parametro è facoltativo e può essere NULL. Se si specifica questo parametro, questa funzione viene usata per installare la classe di interfaccia rappresentata dal GUID. Se questo parametro è NULL, questa funzione viene usata per installare un programma di installazione della classe.
Reserved1
Riservato. Deve essere zero.
Reserved2
Riservato. Deve essere zero.
Valore restituito
SetupDiInstallClassEx restituisce TRUE se ha esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato con una chiamata a GetLastError.
Osservazioni
Il chiamante di questa funzione deve essere membro del gruppo Administrators.
SetupDiInstallClassEx viene in genere chiamato da un programma di installazione della classe per installare una nuova classe di installazione del dispositivo o una nuova classe di interfaccia del dispositivo .
Nota
L'intestazione setupapi.h definisce SetupDiInstallClassEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| 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 |