Funzione SetupDiGetINFClassA (setupapi.h)
La funzione SetupDiGetINFClass restituisce la classe di un file INF del dispositivo specificato.
Sintassi
WINSETUPAPI BOOL SetupDiGetINFClassA(
[in] PCSTR InfName,
[out] LPGUID ClassGuid,
[out] PSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize
);
Parametri
[in] InfName
Puntatore a una stringa con terminazione NULL che specifica 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, inclusa una terminazione NULL, di un nome 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 sono già installate una o più classi con questo nome.
[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
Dimensioni, in caratteri, del buffer a cui punta il parametro ClassName . La lunghezza massima di un nome di classe con terminazione NULL, 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 terminante. 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
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 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 |