DeleteProfileA 함수(userenv.h)
지정된 컴퓨터에서 사용자 프로필 및 모든 사용자 관련 설정을 삭제합니다. 사용자의 프로필을 삭제하려면 호출자에게 관리자 권한이 있어야 합니다.
구문
USERENVAPI BOOL DeleteProfileA(
[in] LPCSTR lpSidString,
[in, optional] LPCSTR lpProfilePath,
[in, optional] LPCSTR lpComputerName
);
매개 변수
[in] lpSidString
형식: LPCTSTR
사용자 SID를 지정하는 문자열에 대한 포인터입니다.
[in, optional] lpProfilePath
형식: LPCTSTR
프로필 경로를 지정하는 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 함수는 레지스트리에서 경로를 가져옵니다.
[in, optional] lpComputerName
형식: LPCTSTR
프로필을 삭제할 컴퓨터의 이름을 지정하는 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 로컬 컴퓨터 이름이 사용됩니다.
참고 Windows Vista 기준으로 이 매개 변수는 NULL이어야 합니다. 그렇지 않으면 오류 코드 ERROR_INVALID_PARAMETER 이 함수가 실패합니다.
반환 값
형식: BOOL
성공하면 TRUE이고, 그렇지 않으면 FALSE입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
로컬 시스템 계정(S-1-5-18)의 SID(보안 식별자)를 전달하면 DeleteProfile이 실패할 수 있습니다.
참고
userenv.h 헤더는 DELETEProfile을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | userenv.h |
| 라이브러리 | Userenv.lib |
| DLL | Userenv.dll |