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 HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion subclave del Registro. La longitud máxima en caracteres, incluido un terminador NULL, de un nombre de archivo INF terminado con 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, incluida una terminación NULL. Este puntero es opcional y se puede NULL.

Valor devuelto

La función devuelve TRUE si se ejecuta correctamente. De lo contrario, devuelve false y el error registrado se puede recuperar con una llamada a GetLastError.

Observaciones

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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
de la plataforma de destino de	Escritorio
encabezado de	setupapi.h (incluya Setupapi.h)
biblioteca de	Setupapi.lib

Consulte también

SetupDiBuildClassInfoList

SetupDiClassGuidsFromName

SetupDiClassNameFromGuid

setupDiGetClassDescription