Funzione SetupDiGetINFClassA (setupapi.h)

Articolo
03/15/2023

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

Vedi anche

SetupDiBuildClassInfoList

SetupDiClassGuidsFromName

SetupDiClassNameFromGuid

SetupDiGetClassDescription

Condividi tramite