Funzione SetupDiInstallClassW (setupapi.h)

La funzione SetupDiInstallClass installa la sezione ClassInstall32 del file INF specificato.

Sintassi

WINSETUPAPI BOOL SetupDiInstallClassW(
  [in, optional] HWND     hwndParent,
  [in]           PCWSTR   InfFileName,
  [in]           DWORD    Flags,
  [in, optional] HSPFILEQ FileQueue
);

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] InfFileName

Puntatore a una stringa con terminazione NULL contenente il nome del file INF che contiene 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 specificato FileQueue . DI_NOVCP indica alla funzione SetupInstallFromInfSection (descritta in Microsoft Windows SDK documentazione) di non creare una coda personalizzata 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 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.

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 questa funzione deve essere membro del gruppo Administrators.

Questa funzione viene chiamata da un programma di installazione di classe quando installa un dispositivo di una nuova classe di dispositivo.

Per installare una classe di interfaccia o una classe di 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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

Vedi anche

SetupDiCallClassInstaller

SetupDiInstallClassEx