Função SHRegGetValueFromHKCUHKLM (shlwapi.h)

[Essa função não tem mais suporte.]

Obtém informações especificadas do registro. Essa função marcar HKEY_CURRENT_USER para as informações solicitadas na subchave especificada. Se as informações não existirem na subárvore HKEY_CURRENT_USER, a função verificará a subárvore HKEY_LOCAL_MACHINE para obter as mesmas informações.

Sintaxe

LSTATUS SHRegGetValueFromHKCUHKLM(
  [in]      PCWSTR pwszKey,
  [in]      PCWSTR pwszValue,
  [in]      SRRF   srrfFlags,
  [out]     DWORD  *pdwType,
  [in]      void   *pvData,
  [in, out] DWORD  *pcbData
);

Parâmetros

[in] pwszKey

Tipo: PCWSTR

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o caminho para a chave do Registro.

[in] pwszValue

Tipo: PCWSTR

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o valor da chave. Esse valor pode ser NULL, caso em que os dados são recuperados do valor Padrão.

[in] srrfFlags

Tipo: SRRF

As constantes de sinalizador SRRF . Se mais de um sinalizador for usado, eles poderão ser combinados usando um OR bit a bit. Esses sinalizadores são usados para restringir o tipo de dados retornados. Esse valor não pode ser 0.

[out] pdwType

Tipo: DWORD*

Quando essa função retorna, contém um ponteiro para um DWORD que recebe um código que indica o tipo de dados armazenados no valor especificado. Isso pode ser definido como NULL se nenhuma informação de tipo for desejada. Se esse valor não for NULL e o sinalizador SRRF_NOEXPAND não tiver sido definido, os tipos de dados de REG_EXPAND_SZ serão retornados como REG_SZ, pois são expandidos automaticamente nesse método.

[in] pvData

Tipo: LPCVOID

Um ponteiro para um buffer que contém os dados do valor. Esse parâmetro poderá ser NULL se os dados não forem necessários. Esse valor deve conter o tamanho do buffer pvData na entrada. Se pvData for NULL (ou se pvData não for NULL, mas muito pequeno de um buffer para armazenar os dados do Registro), ao sair, ele conterá o tamanho necessário para armazenar os dados do Registro.

[in, out] pcbData

Tipo: DWORD*

Quando essa função retorna, contém um ponteiro para o tamanho dos dados, em bytes.

Valor retornado

Tipo: LONG

Se tiver êxito, essa função retornará ERROR_SUCCESS e todos os parâmetros de saída solicitados. Retorna ERROR_MORE_DATA se a função falhar devido a espaço insuficiente em um pvData não NULL fornecido. Nesse caso, somente pdwType e pcbData podem conter dados válidos, pvData será indefinido. Caso contrário, retorna um código de erro diferente de zero definido em Winerror.h . Você pode usar a função FormatMessage com o sinalizador FORMAT_MESSAGE_FROM_SYSTEM para recuperar uma descrição genérica do erro.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
DLL	Shlwapi.dll