Función UnloadUserProfile (userenv.h)

  • Artículo

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

Consulte también

LoadUserProfile

PROFILEINFO

Introducción a los perfiles de usuario

Referencia de perfiles de usuario