Funzione SetupDiClassGuidsFromNameExW (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 SetupDiClassGuidsFromNameExW(
[in] PCWSTR ClassName,
[out] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize,
[in, optional] PCWSTR 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 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.
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
La funzione restituisce TRUE se ha esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato eseguendo una chiamata a GetLastError.
Commenti
I nomi delle classi non devono essere univoci; solo 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
Piattaforma di destinazione | Desktop |
Intestazione | setupapi.h (includere Setupapi.h) |
Libreria | Setupapi.lib |
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per