SHGetFolderLocation 함수(shlobj_core.h)
더 이상 사용되지 않습니다. 폴더의 경로를 ITEMIDLIST 구조체로 검색합니다.
구문
SHSTDAPI SHGetFolderLocation(
[in] HWND hwnd,
[in] int csidl,
[in] HANDLE hToken,
[in] DWORD dwFlags,
[out] PIDLIST_ABSOLUTE *ppidl
);
매개 변수
[in] hwnd
형식: HWND
예약되어 있습니다.
[in] csidl
형식: int
위치할 폴더를 식별하는 CSIDL 값입니다. CSIDL과 연결된 폴더가 특정 시스템에 없을 수 있습니다.
[in] hToken
형식: HANDLE
특정 사용자를 나타내는 데 사용할 수 있는 액세스 토큰 입니다. 일반적으로 NULL로 설정되지만 단일 사용자에 속하는 것으로 처리되는 폴더에 대해 여러 사용자가 있을 때 필요할 수 있습니다. 이 유형의 가장 일반적으로 사용되는 폴더는 내 문서입니다. 호출 애플리케이션은 hToken 이 NULL이 아닌 경우 올바른 가장을 담당합니다. 특정 사용자에 대한 적절한 보안 권한이 있어야 하며 사용자의 레지스트리 하이브가 현재 탑재되어 있어야 합니다. 액세스 제어 문제에 대한 자세한 내용은 Access Control 참조하세요.
hToken 매개 변수에 -1 값을 할당하면 기본 사용자가 표시됩니다. 이렇게 하면 SHGetFolderLocation 의 클라이언트가 기본 사용자에 대한 폴더 위치(예: 데스크톱 폴더)를 찾을 수 있습니다. 기본 사용자 사용자 프로필은 새 사용자 계정을 만들 때 중복되며 내 문서 및 데스크톱과 같은 특수 폴더를 포함합니다. 기본 사용자 폴더에 추가된 모든 항목도 새 사용자 계정에 표시됩니다.
[in] dwFlags
형식:DWORD
[out] ppidl
형식: PIDLIST_ABSOLUTE*
네임스페이스(바탕 화면)의 루트를 기준으로 폴더의 위치를 지정하는 항목 식별자 목록 구조에 대한 포인터의 주소입니다. 실패 시 ppidl 매개 변수가 NULL로 설정됩니다. 호출 애플리케이션은 ILFree를 호출하여 이 리소스를 해제할 책임이 있습니다.
반환 값
형식: HRESULT
성공하면 S_OK 반환하고, 그렇지 않으면 다음을 포함하여 오류 값을 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
nFolder의 CSIDL은 유효하지만 폴더가 없습니다. |
|
nFolder의 CSIDL이 잘못되었습니다. |
설명
이 함수는 이전 버전의 셸 에 포함된 SHGetSpecialFolderLocation의 상위 집합입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional, Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | shlobj_core.h(Shlobj.h 포함) |
| 라이브러리 | Shell32.lib |
| DLL | Shell32.dll(버전 5.0 이상) |