Função SHRegEnumUSKeyA (shlwapi.h)

Enumera as subchaves de uma subchave do Registro em uma subárvore específica do usuário (HKEY_CURRENT_USER ou HKEY_LOCAL_MACHINE).

Sintaxe

LSTATUS SHRegEnumUSKeyA(
  [in]      HUSKEY          hUSKey,
  [in]      DWORD           dwIndex,
  [out]     LPSTR           pszName,
  [in, out] LPDWORD         pcchName,
  [in]      SHREGENUM_FLAGS enumRegFlags
);

Parâmetros

[in] hUSKey

Tipo: HUSKEY

Um identificador para uma subchave do Registro aberta no momento. A subchave deve ter sido aberta com o KEY_SET_VALUE direito de acesso. Para obter mais informações, consulte de Direitos de Acesso e Segurança de Chave do Registro.

Esse identificador pode ser obtido por meio da função SHRegOpenUSKey.

[in] dwIndex

Tipo: DWORD

O índice da subchave a ser recuperada. Esse parâmetro deve ser zero para a primeira chamada e incrementado para chamadas subsequentes.

[out] pszName

Tipo: LPTSTR

Um ponteiro para um buffer de caracteres que recebe o nome da chave enumerada.

[in, out] pcchName

Tipo: LPDWORD

Um ponteiro para um DWORD que, na entrada, contém o tamanho do buffer em pszName, em caracteres. Na saída, isso contém o número de caracteres que foram copiados para pszName.

[in] enumRegFlags

Tipo: SHREGENUM_FLAGS

Um SHREGENUM_FLAGS que especifica a chave base na qual a enumeração deve ocorrer.

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 textual do erro.

Observações

Requisitos