Funzione SetupDiClassGuidsFromNameA (setupapi.h)
La funzione SetupDiClassGuidsFromName recupera i GUID associati al nome della classe specificato. Questo elenco è basato sulle classi attualmente installate nel sistema.
Sintassi
WINSETUPAPI BOOL SetupDiClassGuidsFromNameA(
[in] PCSTR ClassName,
[out] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize
);
Parametri
[in] ClassName
Nome della classe per cui recuperare il 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
Fornisce un 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.
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
Chiamare SetupDiClassGuidsFromNameEx per recuperare i GUID della classe per una classe in un computer remoto.
Nota
L'intestazione setupapi.h definisce SetupDiClassGuidsFromName 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 |