Funzione SetupDiGetINFClassW (setupapi.h)
La funzione SetupDiGetINFClass restituisce la classe di un file INF del dispositivo specificato.
Sintassi
WINSETUPAPI BOOL SetupDiGetINFClassW(
[in] PCWSTR InfName,
[out] LPGUID ClassGuid,
[out] PWSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize
);
Parametri
[in] InfName
Puntatore a una stringa con terminazione NULL che fornisce il nome di un file INF del dispositivo. Questo nome può includere un percorso. Tuttavia, se viene specificato solo il nome del file, il file viene cercato in ogni directory elencata nella voce DevicePath nella sottochiave HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion del Registro di sistema. La lunghezza massima in caratteri, incluso un carattere di terminazione NULL, di un nome di file INF con terminazione NULL è MAX_PATH.
[out] ClassGuid
Puntatore a una variabile di tipo GUID che riceve il GUID della classe per il file INF specificato. Se il file INF non specifica un nome di classe, la funzione restituisce una struttura GUID_NULL. Chiamare SetupDiClassGuidsFromName per determinare se una o più classi con questo nome sono già installate.
[out] ClassName
Puntatore a un buffer che riceve una stringa con terminazione NULL contenente il nome della classe per il file INF specificato. Se il file INF non specifica un nome di classe ma specifica un GUID, questo buffer riceve il nome recuperato chiamando SetupDiClassNameFromGuid. Tuttavia, se SetupDiClassNameFromGuid non riesce a recuperare un nome di classe (ad esempio, la classe non è installata), restituisce una stringa vuota.
[in] ClassNameSize
Dimensione, in caratteri, del buffer a cui punta il parametro ClassName . La lunghezza massima di un nome di classe con terminazione NULL, espressa in caratteri, è MAX_CLASS_NAME_LEN.
[out, optional] RequiredSize
Puntatore a una variabile tipizzata DWORD che riceve il numero di caratteri necessari per archiviare il nome della classe, incluso un valore NULL di terminazione. Questo puntatore è facoltativo e può essere NULL.
Valore restituito
Se la funzione ha esito positivo, la funzione restituisce TRUE . In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato con una chiamata a GetLastError.
Commenti
Non usare questa funzione con i file INF per Windows 9x o Millennium Edition.
Nota
L'intestazione setupapi.h definisce SetupDiGetINFClass 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
| 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 |
| Set di API | ext-ms-win-setupapi-classinstallers-l1-1-2 (introdotto in Windows 10, versione 10.0.14393) |