Share via

estrutura HW_PROFILE_INFOA (winbase.h)

  • Artigo

Contém informações sobre um perfil de hardware. A função GetCurrentHwProfile usa essa estrutura para recuperar o perfil de hardware atual do computador local.

Sintaxe

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

Membros

dwDockInfo

O estado de encaixe relatado do computador. Esse membro pode ser uma combinação dos valores de bit a seguir.

Valor Significado
DOCKINFO_DOCKED
0x2
 O computador está encaixado.
DOCKINFO_UNDOCKED
0x1
 O computador está desencaixado. Esse sinalizador é sempre definido para sistemas de área de trabalho que não podem ser desencaixados.
DOCKINFO_USER_SUPPLIED
0x4
 Se esse sinalizador estiver definido, GetCurrentHwProfile recuperará o estado de encaixe atual das informações fornecidas pelo usuário na página Perfis de Hardwaredo aplicativo do painel de controle do sistema.

Se não houver esse valor ou o valor for definido como 0, esse sinalizador será definido.
DOCKINFO_USER_DOCKED
0x5
 O computador está encaixado, de acordo com as informações fornecidas pelo usuário. Esse valor é uma combinação dos sinalizadores DOCKINFO_USER_SUPPLIED e DOCKINFO_DOCKED.
DOCKINFO_USER_UNDOCKED
0x6
 O computador está desencaixado, de acordo com as informações fornecidas pelo usuário. Esse valor é uma combinação dos sinalizadores DOCKINFO_USER_SUPPLIED e DOCKINFO_UNDOCKED.

szHwProfileGuid[HW_PROFILE_GUIDLEN]

A cadeia de caracteres GUID (identificador global exclusivo) para o perfil de hardware atual. A cadeia de caracteres retornada por GetCurrentHwProfile inclui o GUID em chaves; {}por exemplo:

{12340001-4980-1920-6788-123456789012}

Você pode usar essa cadeia de caracteres como uma subchave do Registro na chave de configuração do aplicativo em HKEY_CURRENT_USER. Isso permite que você armazene as configurações para cada perfil de hardware.

szHwProfileName[MAX_PROFILE_LEN]

O nome de exibição do perfil de hardware atual.

Comentários

Observação

O cabeçalho winbase.h define HW_PROFILE_INFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho winbase.h (inclua Windows.h)

Confira também

GetCurrentHwProfile