CreateUserProfileEx 함수

[이 함수는 Windows Vista를 기준으로 사용할 수 없습니다.]

지정된 사용자에 대한 사용자 프로필을 만듭니다.

구문

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

매개 변수

pSid [in]

형식: PSID

새 사용자의 SID입니다.

lpUserName [in]

형식: LPCTSTR

새 사용자의 사용자 이름을 포함하는 버퍼에 대한 포인터입니다.

lpUserHive [in, optional]

형식: LPCTSTR

사용할 레지스트리 하이브 가 포함된 버퍼에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

lpProfileDir [out, optional]

형식: LPTSTR

이 함수가 반환될 때 사용자의 프로필 디렉터리 경로를 수신하는 버퍼에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

dwDirSize [in]

형식:DWORD

tCHAR에서 lpProfileDir로 지정된 버퍼의 크기입니다.

bWin9xUpg [in]

형식: BOOL

True 이면 Windows 9x에서 프로필 마이그레이션의 일부로 사용자 프로필을 만듭니다. 그렇지 않으면 FALSE입니다.

TRUE이면 사용자 프로필이 기본 프로필 디렉터리(일반적으로 C:\Documents 및 Settings\UserName)에 설정됩니다. 해당 디렉터리가 이미 있는 경우 이 디렉터리가 사용됩니다. 그렇지 않으면 만들어집니다.

FALSE이면 기본 프로필 디렉터리가 없는 경우 만들어집니다. 기본 프로필 디렉터리가 이미 있는 경우 이 사용자 프로필에 대한 새 디렉터리가 만들어집니다.

반환 값

형식: BOOL

새 사용자 프로필을 성공적으로 만들면 TRUE 를 반환합니다. 그렇지 않으면 FALSE입니다.

설명

이 함수는 SDK(소프트웨어 개발 키트) 헤더에 선언되지 않으며 연결된 가져오기 라이브러리가 없습니다. LoadLibrary 및 GetProcAddress 함수를 사용하여 Userenv.dll 연결해야 합니다. 함수의 ANSI 버전인 CreateUserProfileExA 는 Userenv.dll 서수 153으로 참조됩니다. 유니코드 버전 인 CreateUserProfileExW 는 서수 154로 참조됩니다.

요구 사항