Función SetupDiClassNameFromGuidA (setupapi.h)
La función SetupDiClassNameFromGuid recupera el nombre de clase asociado a un GUID de clase.
Sintaxis
WINSETUPAPI BOOL SetupDiClassNameFromGuidA(
[in] const GUID *ClassGuid,
[out] PSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize
);
Parámetros
[in] ClassGuid
Puntero al GUID de clase para el nombre de clase que se va a recuperar.
[out] ClassName
Puntero a un búfer que recibe la cadena terminada en NULL que contiene el nombre de la clase especificada por el puntero en el parámetro ClassGuid.
[in] ClassNameSize
Tamaño, en caracteres, del búfer al que apunta el parámetro ClassName. El tamaño máximo, en caracteres, de un nombre de clase terminada en NULL es MAX_CLASS_NAME_LEN. Para obtener más información sobre el tamaño del nombre de clase, vea la siguiente sección Comentarios.
[out, optional] RequiredSize
Puntero a una variable que recibe el número de caracteres necesarios para almacenar el nombre de clase terminado en NULL solicitado. Este puntero es opcional y se puede 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
Llame a setupDiClassNameFromGuidEx para recuperar el nombre de una clase en un equipo remoto.
setupDiClassNameFromGuid no aplica una restricción sobre la longitud del nombre de clase que puede devolver. Esta función devuelve el tamaño necesario para un nombre de clase terminada en NULL incluso si es mayor que MAX_CLASS_NAME_LEN. Sin embargo, MAX_CLASS_NAME_LEN es la longitud máxima de un nombre de clase terminado con NULL válido. Un autor de llamada nunca debe necesitar un búfer que sea mayor que MAX_CLASS_NAME_LEN. Para obtener más información sobre los nombres de clase, vea la descripción de la entrada clase
Nota
El encabezado setupapi.h define SetupDiClassNameFromGuid 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 |