Funzione SetupDiClassGuidsFromNameExA (setupapi.h)
La funzione SetupDiClassGuidsFromNameEx recupera i GUID associati al nome della classe specificato. Questo elenco risultante contiene le classi attualmente installate in un computer locale o remoto.
Sintassi
WINSETUPAPI BOOL SetupDiClassGuidsFromNameExA(
[in] PCSTR ClassName,
[out] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Parametri
[in] ClassName
Nome della classe per cui recuperare i GUID della classe.
[out] ClassGuidList
Puntatore a una matrice per ricevere l'elenco di GUID associati al nome della classe specificato.
[in] ClassGuidListSize
Numero di GUID nella matrice ClassGuidList
[out] RequiredSize
Puntatore a una variabile che riceve il numero di GUID associati al nome della classe. Se questo numero è maggiore delle dimensioni del buffer di ClassGuidList, il numero indica la dimensione della matrice per archiviare tutti i GUID.
[in, optional] MachineName
Puntatore a una stringa con terminazione NULL contenente il nome di un sistema remoto da cui recuperare i GUID. Questo parametro è facoltativo e può essere NULL. Se MachineName è NULL, viene usato il nome del sistema locale.
Cautela
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 TRUE. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato effettuando una chiamata a GetLastError.
Osservazioni
I nomi delle classi non sono sicuramente univoci; solo i GUID sono univoci. Pertanto, un nome di classe può restituire più guid.
Nota
L'intestazione setupapi.h definisce SetupDiClassGuidsFromNameEx 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 |