Función SetupDiClassGuidsFromNameExW (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 SetupDiClassGuidsFromNameExW(
  [in]           PCWSTR ClassName,
  [out]          LPGUID ClassGuidList,
  [in]           DWORD  ClassGuidListSize,
  [out]          PDWORD RequiredSize,
  [in, optional] PCWSTR 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 en 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 realizando 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 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

SetupDiClassGuidsFromName

SetupDiClassNameFromGuidEx