estrutura HW_PROFILE_INFOW (winbase.h)

Artigo
11/20/2024

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_INFOW {
  DWORD dwDockInfo;
  WCHAR szHwProfileGuid[HW_PROFILE_GUIDLEN];
  WCHAR szHwProfileName[MAX_PROFILE_LEN];
} HW_PROFILE_INFOW, *LPHW_PROFILE_INFOW;

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 recuperou o estado de encaixe atual das informações fornecidas pelo usuário na página perfis de hardware do do aplicativo do painel de controle sistema de . Se não houver esse valor ou se o valor for definido como 0, esse sinalizador será definido.
DOCKINFO_USER_DOCKED 0x5	O computador está encaixado, de acordo com 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 é desencaixado, de acordo com 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 no HKEY_CURRENT_USER. Isso permite que você armazene configurações para cada perfil de hardware.

szHwProfileName[MAX_PROFILE_LEN]

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

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Consulte também

GetCurrentHwProfile

Compartilhar via