Función SetupDiGetHwProfileFriendlyNameA (setupapi.h)
La función SetupDiGetHwProfileFriendlyName recupera el nombre descriptivo asociado a un identificador de perfil de hardware.
Sintaxis
WINSETUPAPI BOOL SetupDiGetHwProfileFriendlyNameA(
[in] DWORD HwProfile,
[out] PSTR FriendlyName,
[in] DWORD FriendlyNameSize,
[out, optional] PDWORD RequiredSize
);
Parámetros
[in] HwProfile
Identificador de perfil de hardware asociado al nombre descriptivo que se va a recuperar. Si este parámetro es 0, se recupera el nombre descriptivo del perfil de hardware actual.
[out] FriendlyName
Puntero a un búfer de cadenas para recibir el nombre descriptivo.
[in] FriendlyNameSize
Tamaño, en caracteres, del búfer de FriendlyName.
[out, optional] RequiredSize
Puntero a una variable de tipo DWORD que recibe el número de caracteres necesarios para recuperar el nombre descriptivo (incluido un terminador 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
Llame a SetupDiGetHwProfileFriendlyNameEx para obtener el nombre descriptivo de un identificador de perfil de hardware en un equipo remoto.
Nota
El encabezado setupapi.h define SetupDiGetHwProfileFriendlyName 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 |