estructura HW_PROFILE_INFOA (winbase.h)

  • Artículo

Contiene información sobre un perfil de hardware. La función GetCurrentHwProfile usa esta estructura para recuperar el perfil de hardware actual del equipo local.

Sintaxis

typedef struct tagHW_PROFILE_INFOA {
  DWORD dwDockInfo;
  CHAR  szHwProfileGuid[HW_PROFILE_GUIDLEN];
  CHAR  szHwProfileName[MAX_PROFILE_LEN];
} HW_PROFILE_INFOA, *LPHW_PROFILE_INFOA;

Miembros

dwDockInfo

Estado de acoplamiento notificado del equipo. Este miembro puede ser una combinación de los siguientes valores de bits.

Valor Significado
DOCKINFO_DOCKED
0x2
 El equipo está acoplado.
DOCKINFO_UNDOCKED
0x1
 El equipo está desacopado. Esta marca siempre se establece para los sistemas de escritorio que no se pueden desacoplar.
DOCKINFO_USER_SUPPLIED
0x4
 Si se establece esta marca, GetCurrentHwProfile recuperó el estado de acoplamiento actual de la información proporcionada por el usuario en la página Perfiles de hardware de la aplicación del panel de control del sistema.

Si no hay ningún valor de este tipo o el valor se establece en 0, se establece esta marca.
DOCKINFO_USER_DOCKED
0x5
 El equipo está acoplado, según la información proporcionada por el usuario. Este valor es una combinación de las marcas DOCKINFO_USER_SUPPLIED y DOCKINFO_DOCKED.
DOCKINFO_USER_UNDOCKED
0x6
 El equipo está desacopado, según la información proporcionada por el usuario. Este valor es una combinación de las marcas DOCKINFO_USER_SUPPLIED y DOCKINFO_UNDOCKED.

szHwProfileGuid[HW_PROFILE_GUIDLEN]

Cadena de identificador único global (GUID) para el perfil de hardware actual. La cadena devuelta por GetCurrentHwProfile incluye el GUID entre llaves; {}por ejemplo:

{12340001-4980-1920-6788-123456789012}

Puede usar esta cadena como subclave del Registro en la clave de configuración de la aplicación en HKEY_CURRENT_USER. Esto le permite almacenar la configuración de cada perfil de hardware.

szHwProfileName[MAX_PROFILE_LEN]

Nombre para mostrar del perfil de hardware actual.

Comentarios

Nota

El encabezado winbase.h define HW_PROFILE_INFO 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 Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado winbase.h (incluye Windows.h)

Consulte también

GetCurrentHwProfile