Função UnloadUserProfile (userenv.h)
Descarrega o perfil de um usuário que foi carregado pela função LoadUserProfile . O chamador deve ter privilégios administrativos no computador. Para obter mais informações, consulte a seção Comentários da função LoadUserProfile .
Sintaxe
USERENVAPI BOOL UnloadUserProfile(
[in] HANDLE hToken,
[in] HANDLE hProfile
);
Parâmetros
[in] hToken
Tipo: HANDLE
Token para o usuário, retornado da função LogonUser, CreateRestrictedToken, DuplicateToken, OpenProcessToken ou OpenThreadToken . O token deve ter acesso TOKEN_IMPERSONATE e TOKEN_DUPLICATE . Para obter mais informações, consulte Direitos de Acesso para objetos Access-Token.
[in] hProfile
Tipo: HANDLE
Manipule para a chave do Registro. Esse valor é o membro hProfile da estrutura PROFILEINFO . Para obter mais informações, consulte a seção Comentários de LoadUserProfile e Direitos de Acesso e Segurança de Chave do Registro.
Retornar valor
Tipo: BOOL
TRUE se tiver êxito; caso contrário, FALSE. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Antes de chamar UnloadUserProfile, você deve garantir que todos os identificadores de chaves que você abriu no hive do registro do usuário sejam fechados. Se você não fechar todos os identificadores abertos do Registro, o perfil do usuário não será descarregado. Para obter mais informações, consulte Segurança da Chave do Registro e Direitos de Acesso e Hives do Registro.
Para obter mais informações sobre como chamar funções que exigem privilégios de administrador, consulte Executando com privilégios especiais.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [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 | userenv.h |
| Biblioteca | Userenv.lib |
| DLL | Userenv.dll |