Estructura PROFILEINFOA (profinfo.h)

Contiene información utilizada 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

Tamaño de esta estructura, en bytes.

dwFlags

Tipo: DWORD

Este miembro puede ser una de las marcas siguientes:

PI_NOUI

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

PI_APPLYPOLICY

No compatible.

lpUserName

Tipo: LPTSTR

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

lpProfilePath

Tipo: LPTSTR

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

lpDefaultPath

Tipo: LPTSTR

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

lpServerName

Tipo: LPTSTR

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

lpPolicyPath

Tipo: LPTSTR

No se usa, establezca en NULL.

hProfile

Tipo: HANDLE

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

Comentarios

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 a 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 total (KEY_ALL_ACCESS). Para obtener más información, consulte las secciones Comentarios de LoadUserProfile, Seguridad de clave del Registro y Derechos de acceso, y Subárboles 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 miembro lpProfilePath 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 Convenciones para prototipos de función.

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]
Encabezado	profinfo.h (incluya Userenv.h)

Consulte también

LoadUserProfile

UnloadUserProfile

Introducción a los perfiles de usuario