Função SHRegOpenUSKeyA (shlwapi.h)

  • Artigo

Abre uma subchave do Registro em uma subárvore específica do usuário (HKEY_CURRENT_USER ou HKEY_LOCAL_MACHINE).

Sintaxe

LSTATUS SHRegOpenUSKeyA(
  [in]           LPCSTR  pszPath,
  [in]           REGSAM  samDesired,
  [in, optional] HUSKEY  hRelativeUSKey,
  [out]          PHUSKEY phNewUSKey,
  [in]           BOOL    fIgnoreHKCU
);

Parâmetros

[in] pszPath

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo com o nome da subchave.

[in] samDesired

Tipo: REGSAM

O acesso de segurança desejado. Para obter mais informações sobre acesso de segurança, consulte REGSAM.

[in, optional] hRelativeUSKey

Tipo: HUSKEY

A chave a ser usada como base para caminhos relativos. Se pszPath for um caminho relativo, a chave especificada será relativa a hRelativeUSKey. Se pszPath for um caminho absoluto, defina hRelativeUSKey como NULL.

[out] phNewUSKey

Tipo: PHUSKEY

Um ponteiro para o identificador da chave aberta.

[in] fIgnoreHKCU

Tipo: BOOL

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

Valor retornado

Tipo: LSTATUS

Retorna ERROR_SUCCESS se tiver êxito ou um código de erro diferente de zero definido em Winerror.h caso contrário. Você pode usar a função FormatMessage com o sinalizador FORMAT_MESSAGE_FROM_SYSTEM para recuperar uma descrição genérica do erro.

Comentários

Observação

O cabeçalho shlwapi.h define SHRegOpenUSKey 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

   
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)