다음을 통해 공유


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수 있습니다. 사용자의 로밍 프로필 경로를 검색하려면 정보 수준 3 또는 4를 지정하여 NetUserGetInfo 함수를 호출합니다. 자세한 내용은 비고를 참조하세요.

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

사용자 프로필 개요