Funzione SetupDiClassNameFromGuidA (setupapi.h)
La funzione SetupDiClassNameFromGuid recupera il nome della classe associato a un GUID di classe.
Sintassi
WINSETUPAPI BOOL SetupDiClassNameFromGuidA(
[in] const GUID *ClassGuid,
[out] PSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize
);
Parametri
[in] ClassGuid
Puntatore al GUID della classe per il nome della classe da recuperare.
[out] ClassName
Puntatore a un buffer che riceve la stringa con terminazione NULL contenente il nome della classe specificata dal puntatore nel parametro ClassGuid .
[in] ClassNameSize
Dimensioni, in caratteri, del buffer a cui punta il parametro ClassName . Le dimensioni massime, in caratteri, di un nome di classe con terminazione NULL sono MAX_CLASS_NAME_LEN. Per altre informazioni sulle dimensioni del nome della classe, vedere la sezione Osservazioni seguenti.
[out, optional] RequiredSize
Puntatore a una variabile che riceve il numero di caratteri necessari per archiviare il nome della classe NULL richiesta. Questo puntatore è facoltativo e può essere NULL.
Valore restituito
La funzione restituisce TRUE se ha esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato con una chiamata a GetLastError.
Commenti
Chiamare SetupDiClassNameFromGuidEx per recuperare il nome di una classe in un computer remoto.
SetupDiClassNameFromGuid non applica una restrizione sulla lunghezza del nome della classe che può restituire. Questa funzione restituisce le dimensioni necessarie per un nome di classe con terminazione NULL anche se è maggiore di MAX_CLASS_NAME_LEN. Tuttavia, MAX_CLASS_NAME_LEN è la lunghezza massima di un nome di classe con terminazione NULL valido. Un chiamante non deve mai avere un buffer maggiore di MAX_CLASS_NAME_LEN. Per altre informazioni sui nomi delle classi, vedere la descrizione della voce Classe di una versione INF.
Nota
L'intestazione setupapi.h definisce SetupDiClassNameFromGuid 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 |