Funzione UnloadUserProfile (userenv.h)

Scarica il profilo di un utente caricato dalla funzione LoadUserProfile . Il chiamante deve disporre di privilegi amministrativi nel computer. Per altre informazioni, vedere la sezione Osservazioni della funzione LoadUserProfile .

Sintassi

USERENVAPI BOOL UnloadUserProfile(
  [in] HANDLE hToken,
  [in] HANDLE hProfile
);

Parametri

[in] hToken

Tipo: HANDLE

Token per l'utente restituito dalla funzione LogonUser, CreateRestrictedToken, DuplicateToken, OpenProcessToken o OpenThreadToken . Il token deve avere accesso TOKEN_IMPERSONATE e TOKEN_DUPLICATE . Per altre informazioni, vedere Diritti di accesso per gli oggetti Access-Token.

[in] hProfile

Tipo: HANDLE

Handle per la chiave del Registro di sistema. Questo valore è il membro hProfile della struttura PROFILEINFO . Per altre informazioni, vedere la sezione Osservazioni di LoadUserProfile e sicurezza delle chiavi del Registro di sistema e diritti di accesso.

Valore restituito

Tipo: BOOL

TRUE se ha esito positivo; in caso contrario, FALSE. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Prima di chiamare UnloadUserProfile , è necessario assicurarsi che tutti gli handle alle chiavi aperti nell'hive del Registro di sistema dell'utente siano chiusi. Se non si chiude tutti gli handle del Registro di sistema aperti, il profilo dell'utente non viene scaricato. Per altre informazioni, vedere Sicurezza delle chiavi del Registro di sistema e Diritti di accesso e Hives del Registro di sistema.

Per altre informazioni sulla chiamata di funzioni che richiedono privilegi di amministratore, vedere Esecuzione con privilegi speciali.

Requisiti

Vedi anche

LoadUserProfile

PROFILEINFO

Panoramica dei profili utente

Informazioni di riferimento per i profili utente