Función SetupDiClassGuidsFromNameExA (setupapi.h)
La función SetupDiClassGuidsFromNameEx recupera los GUID asociados al nombre de clase especificado. Esta lista resultante contiene las clases instaladas actualmente en un equipo local o remoto.
Sintaxis
WINSETUPAPI BOOL SetupDiClassGuidsFromNameExA(
[in] PCSTR ClassName,
[out] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Parámetros
[in] ClassName
Nombre de la clase para la que se van a recuperar los 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 de la matriz ClassGuidList .
[out] RequiredSize
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.
[in, optional] MachineName
Puntero a una cadena terminada en NULL que contiene el nombre de un sistema remoto desde el que recuperar los GUID. Este parámetro es opcional y puede ser NULL. Si MachineName es NULL, se usa el nombre del sistema local.
Precaución
No se admite el uso de esta función para acceder a máquinas remotas a partir de Windows 8 y Windows Server 2012, ya que esta funcionalidad se ha quitado.
Reserved
Debe 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 mediante una llamada a GetLastError.
Comentarios
No se garantiza que los nombres de clase sean únicos; solo los GUID son únicos. Por lo tanto, un nombre de clase puede devolver más de un GUID.
Nota
El encabezado setupapi.h define SetupDiClassGuidsFromNameEx 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 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 |