Funzione SetupDiCreateDeviceInfoListExA (setupapi.h)
La funzione SetupDiCreateDeviceInfoList crea un set di informazioni sul dispositivo vuoto in un computer remoto o locale e, facoltativamente, associa il set a una classe di installazione del dispositivo .
Sintassi
WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoListExA(
[in, optional] const GUID *ClassGuid,
[in, optional] HWND hwndParent,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Parametri
[in, optional] ClassGuid
Puntatore al GUID della classe di installazione del dispositivo da associare al set di informazioni sul dispositivo appena creato. Se questo parametro viene specificato, solo i dispositivi di questa classe possono essere inclusi in questo set di informazioni sul dispositivo. Se questo parametro è impostato su NULL, il set di informazioni sul dispositivo non è associato a una classe di configurazione del dispositivo specifica.
[in, optional] hwndParent
Handle della finestra di primo livello da usare per qualsiasi interfaccia utente correlata a azioni non specifiche del dispositivo, ad esempio una finestra di dialogo select-device che usa l'elenco globale dei driver di classe. Questo handle è facoltativo e può essere NULL. Se non è necessaria una finestra di primo livello specifica, impostare hwndParent su NULL.
[in, optional] MachineName
Puntatore a una stringa con terminazione NULL contenente il nome di un computer in una rete. Se viene specificato un nome, è possibile creare e aprire solo i dispositivi in tale computer in questo set di informazioni sul dispositivo. Se questo parametro è impostato su NULL, il set di informazioni sul dispositivo è destinato ai dispositivi nel computer locale.
Attenzione
L'uso di questa funzione per accedere ai computer remoti non è supportato a partire da Windows 8 e Windows Server 2012, perché questa funzionalità è stata rimossa.
Reserved
Deve essere NULL.
Valore restituito
Se ha esito positivo, la funzione restituisce un handle a un set di informazioni sul dispositivo vuoto. In caso contrario, restituisce INVALID_HANDLE_VALUE. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Il chiamante di questa funzione deve eliminare il set di informazioni sul dispositivo restituito quando non è più necessario chiamando SetupDiDestroyDeviceInfoList.
Se il set di informazioni sul dispositivo è per i dispositivi in un computer remoto (MachineName non è NULL), tutte le operazioni successive su questo set o uno dei relativi elementi deve usare routine che supportano set di informazioni sul dispositivo con elementi remoti. Le routine SetupDiXxx che non forniscono questo supporto, ad esempio SetupDiCallClassInstaller, hanno un'istruzione per tale effetto nella relativa pagina di riferimento.
Nota
L'intestazione setupapi.h definisce SetupDiCreateDeviceInfoListEx 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 |