DeleteAppContainerProfile 함수(userenv.h)

지정된 사용자별 앱별 프로필을 삭제합니다.

참고 존재하지 않는 프로필을 삭제하면 성공이 반환됩니다.

구문

USERENVAPI HRESULT DeleteAppContainerProfile(
  [in] PCWSTR pszAppContainerName
);

[in] pszAppContainerName

CreateAppContainerProfile 함수 호출에서 프로필에 지정된 이름입니다. 이 문자열의 길이는 최대 64자이며 정규식 "[-_)에서 설명하는 패턴에 맞습니다. A-Za-z0-9]+".

이 함수가 성공하면 다음을 포함하여 표준 HRESULT 코드를 반환합니다.

반환 코드	설명
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	메서드가 앱 컨테이너 내에서 호출되는 경우
S_OK	프로필이 성공적으로 삭제되었습니다.
E_INVALIDARG	컨테이너 이름이 NULL이거나 길이에 대해 지정된 제한을 초과하는 경우 입니다.

최상의 결과를 얻으려면 DeleteAppContainerProfile 함수를 호출하기 전에 프로필 스토리지 위치의 모든 파일 핸들을 닫습니다. 그렇지 않으면 이 함수가 프로필의 스토리지 위치를 완전히 제거하지 못할 수 있습니다.

이 함수는 현재 사용자의 프로필을 삭제합니다. 다른 사용자의 프로필을 삭제하려면 해당 사용자를 가장해야 합니다.

함수가 실패하면 프로필의 상태 결정되지 않으며 DeleteAppContainerProfile을 다시 호출하여 작업을 완료해야 합니다.