PROFILEINFOA 구조체(profinfo.h)

사용자 프로필을 로드하거나 언로드할 때 사용되는 정보를 포함합니다.

구문

typedef struct _PROFILEINFOA {
  DWORD             dwSize;
  DWORD             dwFlags;
  MIDL_STRING LPSTR lpUserName;
  MIDL_STRING LPSTR lpProfilePath;
  MIDL_STRING LPSTR lpDefaultPath;
  MIDL_STRING LPSTR lpServerName;
  MIDL_STRING LPSTR lpPolicyPath;
#if ...
  ULONG_PTR         hProfile;
#else
  HANDLE            hProfile;
#endif
} PROFILEINFOA, *LPPROFILEINFOA;

멤버

dwSize

형식:DWORD

이 구조체의 크기(바이트)입니다.

dwFlags

형식:DWORD

이 멤버는 다음 플래그 중 하나일 수 있습니다.

PI_NOUI

프로필 오류 메시지가 표시되지 않도록 합니다.

PI_APPLYPOLICY

지원되지 않습니다.

lpUserName

형식: LPTSTR

사용자 이름에 대한 포인터입니다. 이 멤버는 새 프로필을 저장할 디렉터리의 기본 이름으로 사용됩니다.

lpProfilePath

형식: LPTSTR

로밍 사용자 프로필 경로에 대한 포인터입니다. 사용자에게 로밍 프로필이 없는 경우 이 멤버는 NULL일 수 있습니다. 사용자의 로밍 프로필 경로를 검색하려면 NetUserGetInfo 함수를 호출하여 정보 수준 3 또는 4를 지정합니다. 자세한 내용은 설명 부분을 참조하세요.

lpDefaultPath

형식: LPTSTR

기본 사용자 프로필 경로에 대한 포인터입니다. 이 멤버는 NULL일 수 있습니다.

lpServerName

형식: LPTSTR

NetBIOS 형식의 유효성 검사 도메인 컨트롤러 이름에 대한 포인터입니다.

lpPolicyPath

형식: LPTSTR

사용되지 않음, NULL로 설정합니다.

hProfile

형식: HANDLE

HKEY_CURRENT_USER 레지스트리 하위 트리에 대한 핸들입니다. 자세한 내용은 설명 부분을 참조하세요.

설명

경로를 지정할 때 환경 변수를 사용하지 마세요. LoadUserProfile 함수는 경로에서 %username%과 같은 환경 변수를 확장하지 않습니다.

LoadUserProfile 호출이 성공적으로 반환되면 hProfile 멤버는 전체 액세스(KEY_ALL_ACCESS)로 열린 사용자의 하위 트리 루트에 열린 레지스트리 키 핸들을 받습니다. 자세한 내용은 LoadUserProfile, 레지스트리 키 보안 및 액세스 권한 및 레지스트리Hives의 설명 섹션을 참조하세요.

LoadUserProfile을 호출하는 서비스 및 애플리케이션은 사용자에게 로밍 프로필이 있는지 확인하기 위해 검사 합니다. 사용자에게 로밍 프로필이 있는 경우 해당 경로를 이 구조체의 lpProfilePath 멤버로 지정합니다.

참고

profinfo.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 PROFILEINFO를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	profinfo.h(Userenv.h 포함)

추가 정보

LoadUserProfile

UnloadUserProfile

사용자 프로필 개요