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
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