Función SetupDiClassGuidsFromNameA (setupapi.h)

La función SetupDiClassGuidsFromName recupera los GUID asociados al nombre de clase especificado. Esta lista se basa en las clases instaladas actualmente en el sistema.

Sintaxis

WINSETUPAPI BOOL SetupDiClassGuidsFromNameA(
  [in]  PCSTR  ClassName,
  [out] LPGUID ClassGuidList,
  [in]  DWORD  ClassGuidListSize,
  [out] PDWORD RequiredSize
);

Parámetros

[in] ClassName

Nombre de la clase para la que se va a recuperar el GUID de clase.

[out] ClassGuidList

Puntero a una matriz para recibir la lista de GUID asociados al nombre de clase especificado.

[in] ClassGuidListSize

Número de GUID en la matriz ClassGuidList .

[out] RequiredSize

Proporciona un puntero a una variable que recibe el número de GUID asociados al nombre de clase. Si este número es mayor que el tamaño del búfer ClassGuidList , el número indica el tamaño que debe tener la matriz para almacenar todos los GUID.

Valor devuelto

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

Comentarios

Llame a SetupDiClassGuidsFromNameEx para recuperar los GUID de clase de una clase en un equipo remoto.

Nota:

El encabezado setupapi.h define SetupDiClassGuidsFromName 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

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

SetupDiClassGuidsFromNameEx

SetupDiClassNameFromGuid