Função CreateProfile (userenv.h)

Cria um novo perfil de usuário.

Sintaxe

USERENVAPI HRESULT CreateProfile(
  [in]  LPCWSTR pszUserSid,
  [in]  LPCWSTR pszUserName,
  [out] LPWSTR  pszProfilePath,
  [in]  DWORD   cchProfilePath
);

Parâmetros

[in] pszUserSid

Tipo: LPCWSTR

Ponteiro para o SID do usuário como uma cadeia de caracteres.

[in] pszUserName

Tipo: LPCWSTR

O nome de usuário do novo usuário. Esse nome é usado como o nome base para o diretório de perfil.

[out] pszProfilePath

Tipo: LPWSTR

Quando essa função retorna, contém um ponteiro para o caminho completo do perfil.

[in] cchProfilePath

Tipo: DWORD

Tamanho do buffer apontado por pszProfilePath, em caracteres.

Valor retornado

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro, caso contrário, incluindo o seguinte:

Código de retorno	Descrição
E_ACCESSDENIED	O chamador não tem um nível de permissão suficiente para criar o perfil.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	Já existe um perfil para o usuário especificado.

Comentários

O chamador deve ter privilégios de administrador para chamar essa função.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	userenv.h
Biblioteca	Userenv.lib
DLL	Userenv.dll