Função SHRegOpenUSKeyA (shlwapi.h)

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 à 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 para NULL.

[out] phNewUSKey

Tipo: PHUSKEY

Um ponteiro para o identificador da chave aberta.

[in] fIgnoreHKCU

Tipo: BOOL

A variável que especifica a chave a ser pesquisada. Quando definido como TRUE, SHRegOpenUSKey ignora HKEY_CURRENT_USER e retorna um valor de HKEY_LOCAL_MACHINE.

Valor de retorno

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.

Observações

Requisitos