Estructura PROFILEINFOA (profinfo.h)

Contiene información que se usa al cargar o descargar un perfil de usuario.

Sintaxis

typedef struct _PROFILEINFOA {
  DWORD             dwSize;
  DWORD             dwFlags;
  MIDL_STRING LPSTR lpUserName;
  MIDL_STRING LPSTR lpProfilePath;
  MIDL_STRING LPSTR lpDefaultPath;
  MIDL_STRING LPSTR lpServerName;
  MIDL_STRING LPSTR lpPolicyPath;
#if ...
  ULONG_PTR         hProfile;
#else
  HANDLE            hProfile;
#endif
} PROFILEINFOA, *LPPROFILEINFOA;

Miembros

dwSize

Tipo: DWORD de

Tamaño de esta estructura, en bytes.

dwFlags

Tipo: DWORD de

Este miembro puede ser una de las marcas siguientes:

PI_NOUI

Impide la presentación de mensajes de error de perfil.

PI_APPLYPOLICY

No se admite.

lpUserName

Tipo: LPTSTR de

Puntero al nombre del usuario. Este miembro se usa como nombre base del directorio en el que almacenar un nuevo perfil.

lpProfilePath

Tipo: LPTSTR de

Puntero a la ruta de acceso de perfil de usuario móvil. Si el usuario no tiene un perfil de itinerancia, este miembro puede ser NULL. Para recuperar la ruta de acceso del perfil móvil del usuario, llame a la función NetUserGetInfo, especificando el nivel de información 3 o 4. Para obtener más información, vea Comentarios.

lpDefaultPath

Tipo: LPTSTR de

Puntero a la ruta de acceso del perfil de usuario predeterminada. Este miembro puede ser NULL.

lpServerName

Tipo: LPTSTR de

Puntero al nombre del controlador de dominio de validación, en formato NetBIOS.

lpPolicyPath

Tipo: LPTSTR de

No se usa, establecido en NULL.

hProfile

Tipo: HANDLE de

Identificador del subárbol del Registro HKEY_CURRENT_USER. Para obtener más información, vea Comentarios.

Observaciones

No use variables de entorno al especificar una ruta de acceso. La función LoadUserProfile no expande variables de entorno, como %username%, en una ruta de acceso.

Cuando la llamada de LoadUserProfile se devuelve correctamente, el miembro hProfile recibe un identificador de clave del Registro abierto a la raíz del subárbol del usuario, abierto con acceso completo (KEY_ALL_ACCESS). Para obtener más información, vea las secciones Comentarios de LoadUserProfile, Derechos de acceso y seguridad de claves del Registroy Hives del Registro.

Los servicios y las aplicaciones que llaman a LoadUserProfile deben comprobar si el usuario tiene un perfil móvil. Si el usuario tiene un perfil móvil, especifique su ruta de acceso como el lpProfilePath miembro de esta estructura.

Nota

El encabezado profinfo.h define PROFILEINFO como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
encabezado de	profinfo.h (incluya Userenv.h)

Consulte también

LoadUserProfile

UnloadUserProfile

Información general de perfiles de usuario de