Función CreateProfile (userenv.h)

Crea un nuevo perfil de usuario.

Sintaxis

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

Parámetros

[in] pszUserSid

Tipo: LPCWSTR

Puntero al SID del usuario como una cadena.

[in] pszUserName

Tipo: LPCWSTR

Nombre de usuario del nuevo usuario. Este nombre se usa como nombre base para el directorio del perfil.

[out] pszProfilePath

Tipo: LPWSTR

Cuando esta función vuelve, contiene un puntero a la ruta de acceso completa del perfil.

[in] cchProfilePath

Tipo: DWORD

Tamaño del búfer al que apunta pszProfilePath, en caracteres.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un valor de error, incluido lo siguiente:

Código devuelto	Descripción
E_ACCESSDENIED	El autor de la llamada no tiene un nivel de permiso suficiente para crear el perfil.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	Ya existe un perfil para el usuario especificado.

Comentarios

El autor de la llamada debe tener privilegios de administrador para llamar a esta función.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	userenv.h
Library	Userenv.lib
Archivo DLL	Userenv.dll