SHGetSpecialFolderLocation

SHGetSpecialFolderLocation

특수 폴더의 ITEMIDLIST 구조체에의 포인터(PIDL)(을)를 취득합니다.

HRESULT SHGetSpecialFolderLocation(
    HWND  hwndOwner,
    int   nFolder,
    LPITEMIDLIST *ppidl
);

SHELL32.DLL

인수

hwndOwner

다이알로그 박스나 메시지 박스를 표시할 때의 오너 윈도우의 핸들을 지정합니다.

nFolder

PIDL (을)를 취득하는 폴더를 식별한다 CSIDL 치(을)를 지정합니다.

ppidl

쉘 네임 스페이스의 루트( 「데스크탑」폴더)로부터의 폴더의 상대적인 위치를 지정하는 아이템 ID 리스트에의 포인터(PIDL)(을)를 격납하는 변수의 주소를 지정합니다.호출측 어플리케이션은, SHGetMalloc 함수에 의해서 취득할 수 있는 쉘의 IMalloc 인터페이스를 사용해 이 포인터를 해방하지 않으면 안됩니다.

반환값

함수가 성공하면 0 (S_OK) 하지만 돌아갑니다.

함수가 실패하면 OLE 정의의 에러치가 돌아갑니다.

해설

Shell32.dll Version 5.00 이후에서는, 이 함수는 SHGetFolderLocation 함수에 교체되었습니다.

대응 정보

Shell32.dll Version 4.00 이후

Windows 95 이후 / Windows NT 4.0 이후