폴더 형식으로 지정된 셸 네임스페이스 항목과 해당 폴더를 기준으로 하는 항목 식별자 목록을 지정하면 이 함수는 네임스페이스 항목의 부모에 바인딩되고 선택적으로 항목 식별자 목록의 최종 구성 요소에 대한 포인터를 반환합니다.
Syntax
SHSTDAPI SHBindToFolderIDListParent(
[in, optional] IShellFolder *psfRoot,
[in] PCUIDLIST_RELATIVE pidl,
[in] REFIID riid,
[out] void **ppv,
[out, optional] PCUITEMID_CHILD *ppidlLast
);
매개 변수
[in, optional] psfRoot
형식: IShellFolder*
Shell 폴더 개체에 대한 포인터입니다. psfRoot가 NULL인 경우 전달된 IDList가 데스크톱을 기준으로 했음을 나타냅니다.
[in] pidl
형식: PCUIDLIST_RELATIVE
psfRoot를 기준으로 바인딩할 PIDL입니다. psfRoot가 NULL이면 데스크톱 폴더에 상대적인 절대 IDList입니다.
[in] riid
형식: REFIID
원하는 인터페이스 ID에 대한 참조입니다. 이는 일반적으로 IID_IShellFolder 또는 IID_IShellFolder2 대상 폴더에서 지원하는 모든 항목일 수 있습니다.
[out] ppv
형식: void**
이 함수가 반환되면 riid에서 요청된 인터페이스 포인터를 포함합니다. 일반적으로 IShellFolder 또는 IShellFolder2이지만 대상 폴더에서 지원하는 모든 항목일 수 있습니다.
[out, optional] ppidlLast
형식: PCUITEMID_CHILD*
pidl 매개 변수의 마지막 ID에 대한 포인터이며 ppv에서 반환된 부모 폴더를 기준으로 하는 자식 ID입니다. 이 값은 NULL 수 있습니다.
반환 값
형식: HRESULT
이 함수가 성공하면 S_OK 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.
비고
메모SHBindToFolderIDListParent 함수를 호출하는 것은 NULL을 사용하여 SHBindToFolderIDListParentEx 함수를 바인딩 컨텍스트로 호출하는 것과 같습니다.
요구 사항
| 요구 사항 | 가치 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | 윈도우즈 |
| Header | shlobj_core.h(Shlobj.h 포함) |
| Library | OneCore.Lib |
| DLL | Shell32.dll |