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에 도입됨)

추가 정보

SHGetSpecialFolderPath