CreateProfile 함수(userenv.h)

새 사용자 프로필을 만듭니다.

구문

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

매개 변수

[in] pszUserSid

형식: LPCWSTR

문자열로 사용자의 SID에 대한 포인터입니다.

[in] pszUserName

형식: LPCWSTR

새 사용자의 사용자 이름입니다. 이 이름은 프로필 디렉터리의 기본 이름으로 사용됩니다.

[out] pszProfilePath

형식: LPWSTR

이 함수가 반환되면 프로필의 전체 경로에 대한 포인터가 포함됩니다.

[in] cchProfilePath

형식:DWORD

pszProfilePath가 가리키는 버퍼의 크기(문자)입니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 다음을 포함하여 오류 값을 반환합니다.

반환 코드	Description
E_ACCESSDENIED	호출자에게 프로필을 만들 수 있는 충분한 사용 권한 수준이 없습니다.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	지정된 사용자에 대한 프로필이 이미 있습니다.

설명

호출자는 이 함수를 호출할 수 있는 관리자 권한이 있어야 합니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	userenv.h
라이브러리	Userenv.lib
DLL	Userenv.dll