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 de
[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 classGuidList búfer, el número indica el tamaño de 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 se puede NULL. Si MachineName es null, se usa el nombre del sistema local.
Cautela
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 ejecuta correctamente. De lo contrario, devuelve FALSE y se puede recuperar el error registrado realizando una llamada a GetLastError.
Observaciones
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 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 |