GetAppContainerFolderPath 함수(userenv.h)
지정된 앱 컨테이너에 대한 로컬 앱 데이터 폴더의 경로를 가져옵니다.
구문
USERENVAPI HRESULT GetAppContainerFolderPath(
[in] PCWSTR pszAppContainerSid,
[out] PWSTR *ppszPath
);
매개 변수
[in] pszAppContainerSid
앱 컨테이너의 SID에 대한 포인터입니다.
[out] ppszPath
이 함수가 성공적으로 반환될 때 로컬 폴더의 경로를 수신하는 문자열에 대한 포인터의 주소입니다. CoTaskMemFree 함수를 호출하여 더 이상 필요하지 않은 경우 이 문자열을 해제하는 것은 호출자의 책임입니다.
반환 값
이 함수는 다음을 포함하지만 이에 국한되지 않는 HRESULT 코드를 반환합니다.
반환 코드 | Description |
---|---|
|
작업이 성공적으로 완료되었습니다. |
|
pszAppContainerSid 또는 ppszPath 매개 변수는 NULL입니다. |
설명
이 함수를 통해 검색된 경로는 FOLDERID_LocalAppData 사용하여 SHGetKnownFolderPath 함수를 호출하여 가져오는 경로와 동일합니다.
스레드 토큰이 설정된 경우 이 함수는 현재 사용자에 대해 앱 컨테이너를 사용합니다. 스레드 토큰이 설정되지 않은 경우 이 함수는 프로세스 ID와 연결된 앱 컨테이너를 사용합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | userenv.h |
라이브러리 | Userenv.lib |
DLL | Userenv.dll |