Función SetupDiClassNameFromGuidExA (setupapi.h)

La función setupDiClassNameFromGuidEx recupera el nombre de clase asociado a un GUID de clase. La clase se puede instalar en un equipo local o remoto.

Sintaxis

WINSETUPAPI BOOL SetupDiClassNameFromGuidExA(
  [in]            const GUID *ClassGuid,
  [out]           PSTR       ClassName,
  [in]            DWORD      ClassNameSize,
  [out, optional] PDWORD     RequiredSize,
  [in, optional]  PCSTR      MachineName,
                  PVOID      Reserved
);

Parámetros

[in] ClassGuid

GUID de clase del nombre de clase que se va a recuperar.

[out] ClassName

Puntero a un búfer de cadenas que recibe el nombre terminado en NULL de la clase para el GUID especificado.

[in] ClassNameSize

Tamaño, en caracteres, del búfer de ClassName.

[out, optional] RequiredSize

Número de caracteres necesarios para almacenar el nombre de clase (incluido un valor NULL de terminación). requiredSize siempre es menor que MAX_CLASS_NAME_LEN.

[in, optional] MachineName

Puntero a una cadena terminada en NULL que contiene el nombre de un sistema remoto en el que está instalada la clase. 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 el error registrado se puede recuperar con una llamada a GetLastError.

Observaciones

Nota

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

SetupDiClassGuidsFromNameEx

SetupDiClassNameFromGuid