Função SHRegEnumUSValueA (shlwapi.h)

Enumera os valores da subchave do Registro especificada em uma subárvore específica do usuário (HKEY_CURRENT_USER ou HKEY_LOCAL_MACHINE).

Sintaxe

LSTATUS SHRegEnumUSValueA(
  [in]                HUSKEY          hUSkey,
  [in]                DWORD           dwIndex,
  [out]               LPSTR           pszValueName,
  [in, out]           LPDWORD         pcchValueName,
  [out, optional]     LPDWORD         pdwType,
  [out, optional]     void            *pvData,
  [in, out, optional] LPDWORD         pcbData,
  [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 direito de acesso KEY_SET_VALUE. Para obter mais informações, consulte Segurança de chave do Registro e Direitos de Acesso.

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

[in] dwIndex

Tipo: DWORD

O índice do valor a ser recuperado. Esse parâmetro deve ser zero para a primeira chamada e incrementado para chamadas subsequentes.

[out] pszValueName

Tipo: LPTSTR

Um ponteiro para um buffer de caracteres que recebe o nome do valor enumerado. O tamanho desse buffer é especificado em pcchValueNameLen.

[in, out] pcchValueName

Tipo: LPDWORD

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

[out, optional] pdwType

Tipo: LPDWORD

Um ponteiro para um DWORD que recebe o tipo de dados do valor. Esses são os mesmos valores descritos no parâmetro lpType de RegEnumValue.

[out, optional] pvData

Tipo: void*

Um ponteiro para um buffer que recebe os dados para a entrada de valor. O tamanho desse buffer é especificado em pcbData. Esse parâmetro poderá ser NULL se os dados não forem necessários.

[in, out, optional] pcbData

Tipo: LPDWORD

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

[in] enumRegFlags

Tipo: SHREGENUM_FLAGS

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

Retornar valor

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.

Comentários

Requisitos