SHGetSpecialFolderLocation 함수(shlobj_core.h)
[SHGetSpecialFolderLocation 은 지원되지 않으며 나중에 변경되거나 사용할 수 없습니다. 대신 SHGetFolderLocation을 사용합니다.]
특수 폴더의 ITEMIDLIST 구조에 대한 포인터를 검색합니다.
구문
HRESULT SHGetSpecialFolderLocation(
[in] HWND hwnd,
[in] int csidl,
[out] PIDLIST_ABSOLUTE *ppidl
);
매개 변수
[in] hwnd
형식: HWND
예약되어 있습니다.
[in] csidl
형식: int
관심 있는 폴더를 식별하는 CSIDL 값입니다.
[out] ppidl
형식: PIDLIST_ABSOLUTE*
네임스페이스(바탕 화면)의 루트를 기준으로 폴더의 위치를 지정하는 PIDL입니다. CoTaskMemFree를 사용하여 반환된 IDList를 해제하는 것은 호출 애플리케이션의 책임입니다.
반환 값
형식: HRESULT
이 함수가 성공하면 S_OK 반환합니다. 성공하지 않으면 HRESULT 오류 코드를 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | shlobj_core.h(Shlobj.h 포함) |
| 라이브러리 | Shell32.lib |
| DLL | Shell32.dll(버전 4.0 이상) |
| API 세트 | ext-ms-win-shell-shell32-l1-2-1(Windows 10 버전 10.0.10240에 도입됨) |