Função GetCurrentHwProfileA (winbase.h)

Recupera informações sobre o perfil de hardware atual do computador local.

Sintaxe

BOOL GetCurrentHwProfileA(
  [out] LPHW_PROFILE_INFOA lpHwProfileInfo
);

Parâmetros

[out] lpHwProfileInfo

Um ponteiro para uma estrutura HW_PROFILE_INFO que recebe informações sobre o perfil de hardware atual.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função GetCurrentHwProfile recupera o nome de exibição e a cadeia de caracteres GUID (identificador global exclusivo) para o perfil de hardware. A função também recupera o estado de encaixe relatado para computadores portáteis com estações de encaixe.

O sistema gera um GUID para cada perfil de hardware e o armazena como uma cadeia de caracteres no registro. Você pode usar GetCurrentHwProfile para recuperar a cadeia de caracteres GUID a ser usada como uma subchave do Registro na chave de configuração do aplicativo em HKEY_CURRENT_USER. Isso permite que você armazene as configurações de cada usuário para cada perfil de hardware. Por exemplo, o aplicativo painel de controle Cores pode usar a subchave para armazenar as preferências de cor de cada usuário para diferentes perfis de hardware, como perfis para os estados encaixados e desencaixados. Os aplicativos que usam essa funcionalidade podem marcar o perfil de hardware atual quando são iniciados e atualizar suas configurações adequadamente.

Os aplicativos também podem atualizar suas configurações quando uma mensagem de dispositivo do sistema, como DBT_CONFIGCHANGED, indica que o perfil de hardware foi alterado.

Para compilar um aplicativo que usa essa função, defina a macro _WIN32_WINNT como 0x0400 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Exemplos

#include <windows.h>
#include <stdio.h>
#include <tchar.h>

void main(void) 
{
   HW_PROFILE_INFO   HwProfInfo;
   if (!GetCurrentHwProfile(&HwProfInfo)) 
   {
      _tprintf(TEXT("GetCurrentHwProfile failed with error %lx\n"), 
                 GetLastError());
      return;
   }
   _tprintf(TEXT("DockInfo = %d\n"), HwProfInfo.dwDockInfo);
   _tprintf(TEXT("Profile Guid = %s\n"), HwProfInfo.szHwProfileGuid);
   _tprintf(TEXT("Friendly Name = %s\n"), HwProfInfo.szHwProfileName);
}

Observação

O cabeçalho winbase.h define GetCurrentHwProfile 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]
Plataforma de Destino	Windows
Cabeçalho	winbase.h (inclua Windows.h)
Biblioteca	Advapi32.lib
DLL	Advapi32.dll
Conjunto de APIs	ext-ms-win-advapi32-hwprof-l1-1-0 (introduzido no Windows 10, versão 10.0.10240)

Confira também

DBT_CONFIGCHANGED

HW_PROFILE_INFO

Funções de informações do sistema