Función SetupDiGetHwProfileFriendlyNameA (setupapi.h)

  • Artículo

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 cadena para recibir el nombre descriptivo.

[in] FriendlyNameSize

Tamaño, en caracteres, del búfer 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 realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar realizando una llamada a GetLastError.

Comentarios

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 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

SetupDiGetHwProfileFriendlyNameEx

SetupDiGetHwProfileList