Función SetupDiGetClassDescriptionA (setupapi.h)
La función
Sintaxis
WINSETUPAPI BOOL SetupDiGetClassDescriptionA(
[in] const GUID *ClassGuid,
[out] PSTR ClassDescription,
[in] DWORD ClassDescriptionSize,
[out, optional] PDWORD RequiredSize
);
Parámetros
[in] ClassGuid
GUID de la clase de instalación cuya descripción se va a recuperar.
[out] ClassDescription
Puntero a un búfer de caracteres que recibe la descripción de la clase.
[in] ClassDescriptionSize
Tamaño, en caracteres, del búfer ClassDescription.
[out, optional] RequiredSize
Puntero a variable de tipo DWORD que recibe el tamaño, en caracteres, necesario para almacenar la descripción de clase (incluido un terminador NULL). requiredSize siempre es menor que LINE_LEN. Este parámetro 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 setupDiGetClassDescriptionEx para recuperar la descripción de una clase de instalación instalada en un equipo remoto.
Nota
El encabezado setupapi.h define SetupDiGetClassDescription 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 |