Función CreateUserProfileEx

[Esta función no está disponible a partir de Windows Vista.]

Crea un perfil de usuario para un usuario especificado.

Sintaxis

BOOL WINAPI CreateUserProfileEx(
  _In_      PSID    pSid,
  _In_      LPCTSTR lpUserName,
  _In_opt_  LPCTSTR lpUserHive,
  _Out_opt_ LPTSTR  lpProfileDir,
  _In_      DWORD   dwDirSize,
  _In_      BOOL    bWin9xUpg
);

Parámetros

pSid [in]

Tipo: PSID

SiD del nuevo usuario.

lpUserName [in]

Tipo: LPCTSTR

Puntero a un búfer que contiene el nombre de usuario del nuevo usuario.

lpUserHive [in, opcional]

Tipo: LPCTSTR

Puntero a un búfer que contiene el subárbol del Registro que se va a usar. Este parámetro puede ser NULL.

lpProfileDir [out, optional]

Tipo: LPTSTR

Puntero a un búfer que, cuando esta función devuelve, recibe la ruta de acceso del directorio del perfil del usuario. Este parámetro puede ser NULL.

dwDirSize [in]

Tipo: DWORD

Tamaño del búfer especificado por lpProfileDir, en TCHAR.

bWin9xUpg [in]

Tipo: BOOL

TRUE si el perfil de usuario se crea como parte de una migración de perfil desde Windows 9x; de lo contrario, FALSE.

Cuando es TRUE, el perfil de usuario se configura en el directorio de perfiles predeterminado, normalmente C:\Documents and Settings\UserName. Si ese directorio ya existe, se usa. Si no es así, se crea.

Si es FALSE, se crea el directorio de perfil predeterminado si no existe. Si el directorio de perfil predeterminado ya existe, se crea un nuevo directorio para este perfil de usuario.

Valor devuelto

Tipo: BOOL

Devuelve TRUE si el nuevo perfil de usuario se creó correctamente; de lo contrario, FALSE.

Comentarios

Esta función no se declara en los encabezados del Kit de desarrollo de software (SDK) y no tiene ninguna biblioteca de importación asociada. Debe usar las funciones LoadLibrary y GetProcAddress para vincular a Userenv.dll. Se hace referencia a la versión ANSI de la función CreateUserProfileExA desde Userenv.dll como ordinal 153. Se hace referencia a la versión Unicode CreateUserProfileExW como ordinal 154.

Requisitos

Requisito	Value
Fin de compatibilidad de cliente	Windows XP
Archivo DLL	Userenv.dll
Nombres Unicode y ANSI	CreateUserProfileExW (Unicode) y CreateUserProfileExA (ANSI)