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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | userenv.h |
| Libreria | Userenv.lib |
| DLL | Userenv.dll |