Función UnloadUserProfile (userenv.h)
Descarga el perfil de un usuario cargado por la función LoadUserProfile . El autor de la llamada debe tener privilegios administrativos en el equipo. Para obtener más información, vea la sección Comentarios de la función LoadUserProfile .
Sintaxis
USERENVAPI BOOL UnloadUserProfile(
[in] HANDLE hToken,
[in] HANDLE hProfile
);
Parámetros
[in] hToken
Tipo: HANDLE
Token para el usuario, devuelto por la función LogonUser, CreateRestrictedToken, DuplicateToken, OpenProcessToken o OpenThreadToken . El token debe tener acceso TOKEN_IMPERSONATE y TOKEN_DUPLICATE . Para obtener más información, vea Derechos de acceso para objetos Access-Token.
[in] hProfile
Tipo: HANDLE
Identificador de la clave del Registro. Este valor es el miembro hProfile de la estructura PROFILEINFO . Para obtener más información, vea la sección Comentarios de LoadUserProfile y Derechos de acceso y seguridad de clave del Registro.
Valor devuelto
Tipo: BOOL
TRUE si se ejecuta correctamente; de lo contrario, FALSE. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Antes de llamar a UnloadUserProfile , debe asegurarse de que se cierran todos los identificadores de las claves que ha abierto en el subárbol del registro del usuario. Si no cierra todos los identificadores abiertos del Registro, el perfil del usuario no se puede descargar. Para más información, consulte Derechos de acceso y seguridad de clave del Registro y Subárboles del Registro.
Para obtener más información sobre las funciones de llamada que requieren privilegios de administrador, consulte Ejecución con privilegios especiales.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | userenv.h |
| Library | Userenv.lib |
| Archivo DLL | Userenv.dll |