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 siguientes marcas:
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 , especificando 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, establecido 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 ySubá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 un 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
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) |