Funzione SetupDiSetClassInstallParamsW (setupapi.h)
La funzione SetupDiSetClassInstallParams imposta o cancella i parametri di installazione della classe per un set di informazioni sul dispositivo o un particolare elemento di informazioni sul dispositivo.
Sintassi
WINSETUPAPI BOOL SetupDiSetClassInstallParamsW(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in, optional] PSP_CLASSINSTALL_HEADER ClassInstallParams,
[in] DWORD ClassInstallParamsSize
);
Parametri
[in] DeviceInfoSet
Handle per il set di informazioni sul dispositivo per il quale impostare i parametri di installazione della classe.
[in, optional] DeviceInfoData
Puntatore a una struttura SP_DEVINFO_DATA che rappresenta il dispositivo per cui impostare i parametri di installazione della classe. Questo parametro è facoltativo e può essere NULL. Se questo parametro viene specificato, SetupDiSetClassInstallParams imposta i parametri di installazione della classe per il dispositivo specificato. Se questo parametro è NULL, SetupDiSetClassInstallParams imposta i parametri di installazione della classe associati a DeviceInfoSet.
[in, optional] ClassInstallParams
Puntatore a un buffer che contiene i nuovi parametri di installazione della classe da usare. La struttura SP_CLASSINSTALL_HEADER all'inizio di questo buffer deve avere il campo cbSize impostato su sizeof(SP_CLASSINSTALL_HEADER) e il campo InstallFunction deve essere impostato sul codice DI_FUNCTION che riflette il tipo di parametri contenuti nel resto del buffer.
Se ClassInstallParams non viene specificato, i parametri di installazione della classe corrente, se presenti, vengono cancellati per il set di informazioni o l'elemento del dispositivo specificato.
[in] ClassInstallParamsSize
Dimensioni, in byte, del buffer ClassInstallParams . Se il buffer non viene fornito , ovvero i parametri di installazione della classe vengono cancellati, ClassInstallParamsSize deve essere 0.
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
Tutti i parametri vengono convalidati prima che vengano apportate modifiche. Pertanto, un valore restituito false indica che non sono stati modificati parametri.
Un effetto collaterale dell'impostazione dei parametri di installazione della classe è che è impostato il flag DI_CLASSINSTALLPARAMS. Se il chiamante vuole impostare i parametri, ma disabilitarne l'uso, questo flag deve essere cancellato da una chiamata a SetupDiSetDeviceInstallParams.
Se i parametri di installazione della classe vengono cancellati, il flag DI_CLASSINSTALLPARAMS viene reimpostato.
Nota
L'intestazione setupapi.h definisce SetupDiSetClassInstallParams 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 |
| Set di API | ext-ms-win-setupapi-classinstallers-l1-1-0 (introdotto in Windows 8) |