Función SetupDiGetINFClassA (setupapi.h)
La función SetupDiGetINFClass devuelve la clase de un archivo INF de dispositivo especificado.
Sintaxis
WINSETUPAPI BOOL SetupDiGetINFClassA(
[in] PCSTR InfName,
[out] LPGUID ClassGuid,
[out] PSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize
);
Parámetros
[in] InfName
Puntero a una cadena terminada en NULL que proporciona el nombre de un archivo INF de dispositivo. Este nombre puede incluir una ruta de acceso. Sin embargo, si solo se especifica el nombre de archivo, se busca el archivo en cada directorio que aparece en la entrada DevicePath en la subclave HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion del Registro. La longitud máxima en caracteres, incluido un terminador NULL, de un nombre de archivo INF terminado en NULL es MAX_PATH.
[out] ClassGuid
Puntero a una variable de tipo GUID que recibe el GUID de clase para el archivo INF especificado. Si el archivo INF no especifica un nombre de clase, la función devuelve una estructura GUID_NULL. Llame a SetupDiClassGuidsFromName para determinar si una o varias clases con este nombre ya están instaladas.
[out] ClassName
Puntero a un búfer que recibe una cadena terminada en NULL que contiene el nombre de la clase para el archivo INF especificado. Si el archivo INF no especifica un nombre de clase, pero especifica un GUID, este búfer recibe el nombre que se recupera llamando a SetupDiClassNameFromGuid. Sin embargo, si SetupDiClassNameFromGuid no puede recuperar un nombre de clase (por ejemplo, la clase no está instalada), devuelve una cadena vacía.
[in] ClassNameSize
Tamaño, en caracteres, del búfer al que apunta el parámetro ClassName . La longitud máxima de un nombre de clase terminada en NULL, en caracteres, es MAX_CLASS_NAME_LEN.
[out, optional] RequiredSize
Puntero a una variable con tipo DWORD que recibe el número de caracteres necesarios para almacenar el nombre de clase, incluido un valor NULL de terminación. Este puntero es opcional y puede ser NULL.
Valor devuelto
La función devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar con una llamada a GetLastError.
Comentarios
No use esta función con archivos INF para Windows 9x o Millennium Edition.
Nota
El encabezado setupapi.h define SetupDiGetINFClass como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | setupapi.h (incluya Setupapi.h) |
| Library | Setupapi.lib |