Função CreateUserProfileEx

[Essa função não está disponível a partir do Windows Vista.]

Cria um perfil de usuário para um usuário especificado.

Sintaxe

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

O SID do novo usuário.

lpUserName [in]

Tipo: LPCTSTR

Ponteiro para um buffer que contém o nome de usuário do novo usuário.

lpUserHive [in, opcional]

Tipo: LPCTSTR

Ponteiro para um buffer que contém o hive do Registro a ser usado. Este parâmetro pode ser NULL.

lpProfileDir [out, opcional]

Tipo: LPTSTR

Ponteiro para um buffer que, quando essa função retorna, recebe o caminho do diretório de perfil do usuário. Este parâmetro pode ser NULL.

dwDirSize [in]

Tipo: DWORD

Tamanho do buffer especificado por lpProfileDir, em TCHARs.

bWin9xUpg [in]

Tipo: BOOL

TRUE se o perfil de usuário estiver sendo criado como parte de uma migração de perfil do Windows 9x; caso contrário, FALSE.

Quando TRUE, o perfil de usuário é configurado no diretório de perfil padrão— normalmente C:\Documents and Settings\UserName. Se esse diretório já existir, ele será usado. Se isso não acontecer, ele será criado.

Se FALSE, o diretório de perfil padrão será criado se ele não existir. Se o diretório de perfil padrão já existir, um novo diretório será criado para esse perfil de usuário.

Valor retornado

Tipo: BOOL

Retornará TRUE se o novo perfil de usuário tiver sido criado com êxito; caso contrário, FALSE.

Comentários

Essa função não é declarada nos cabeçalhos do SDK (software development kit) e não tem nenhuma biblioteca de importação associada. Você deve usar as funções LoadLibrary e GetProcAddress para vincular a Userenv.dll. A versão ANSI da função CreateUserProfileExA é referenciada de Userenv.dll como ordinal 153. A versão Unicode , CreateUserProfileExW , é referenciada como ordinal 154.

Requisitos

Requisito	Valor
Fim do suporte ao cliente	Windows XP
DLL	Userenv.dll
Nomes Unicode e ANSI	CreateUserProfileExW (Unicode) e CreateUserProfileExA (ANSI)