Função SHRegGetBoolUSValueA (shlwapi.h)

  • Artigo

Recupera um valor booliano de uma subchave do Registro em uma subárvore específica do usuário (HKEY_CURRENT_USER ou HKEY_LOCAL_MACHINE).

Sintaxe

BOOL SHRegGetBoolUSValueA(
  [in]           LPCSTR pszSubKey,
  [in, optional] LPCSTR pszValue,
  [in]           BOOL   fIgnoreHKCU,
  [in]           BOOL   fDefault
);

Parâmetros

[in] pszSubKey

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo com o nome da subchave relativa a HKEY_LOCAL_MACHINE e HKEY_CURRENT_USER. Por exemplo, "Software\MyCompany\MyProduct".

[in, optional] pszValue

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do valor. Esse valor pode ser NULL.

[in] fIgnoreHKCU

Tipo: BOOL

Uma variável que especifica em qual chave procurar. Quando definido como TRUE, SHRegGetUSValue ignora HKEY_CURRENT_USER e retorna um valor de HKEY_LOCAL_MACHINE.

[in] fDefault

Tipo: BOOL

Um valor retornado se não houver nenhum valor do Registro.

Retornar valor

Tipo: BOOL

Retorna o valor do registro ou fDefault se nenhum for encontrado.

Comentários

Observação

O cabeçalho shlwapi.h define SHRegGetBoolUSValue 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, Windows XP [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 shlwapi.h
Biblioteca Shlwapi.lib
DLL Shlwapi.dll (versão 4.71 ou posterior)