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

Consulte también

SetupDiBuildClassInfoList

SetupDiClassGuidsFromName

SetupDiClassNameFromGuid

SetupDiGetClassDescription