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 포함) |