Função UnloadUserProfile (userenv.h)

  • Artigo

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

Confira também

LoadUserProfile

PROFILEINFO

Visão geral de perfis de usuário

Referência de perfis de usuário