Função SHGetValueW (shlwapi.h)
Recupera um valor do Registro.
Sintaxe
LSTATUS SHGetValueW(
[in] HKEY hkey,
[in, optional] LPCWSTR pszSubKey,
[in, optional] LPCWSTR pszValue,
[out, optional] DWORD *pdwType,
[out, optional] void *pvData,
[in, out, optional] DWORD *pcbData
);
Parâmetros
[in] hkey
Tipo: HKEY
Um identificador para a chave aberta no momento ou qualquer um dos valores predefinidos a seguir.
HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_PERFORMANCE_DATA
HKEY_USERS
[in, optional] pszSubKey
Tipo: LPCTSTR
O endereço de uma cadeia de caracteres terminada em nulo que especifica o nome da subchave da qual recuperar o valor.
[in, optional] pszValue
Tipo: LPCTSTR
O endereço do valor.
[out, optional] pdwType
Tipo: LPDWORD
O tipo do valor. Para obter mais informações, consulte Tipos de dados do Registro.
[out, optional] pvData
Tipo: LPVOID
O endereço do buffer de dados de destino.
[in, out, optional] pcbData
Tipo: LPDWORD
O tamanho do buffer de dados de destino.
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 genérica do erro.
Comentários
Se o aplicativo precisar definir/recuperar uma série de valores na mesma chave, é melhor abrir a chave uma vez e definir/recuperar os valores com as funções regulares do Registro do Microsoft Win32 em vez de usar essa função repetidamente.
Observação
O cabeçalho shlwapi.h define SHGetValue 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
Requisito | Valor |
---|---|
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) |
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de