Compartilhar via

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 a chave a ser pesquisada. 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.

Valor de retorno

Tipo: BOOL

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

Observações

Nota

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 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, Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho shlwapi.h
biblioteca Shlwapi.lib
de DLL Shlwapi.dll (versão 4.71 ou posterior)