SHBindToFolderIDListParent 함수(shlobj_core.h)

폴더 형식으로 지정된 셸 네임스페이스 항목과 해당 폴더를 기준으로 하는 항목 식별자 목록이 있는 경우 이 함수는 네임스페이스 항목의 부모에 바인딩하고 필요에 따라 항목 식별자 목록의 최종 구성 요소에 대한 포인터를 반환합니다.

구문

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인 경우 데스크톱 폴더에 상대적인 절대 ID 목록입니다.

[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 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlobj_core.h(Shlobj.h 포함)
DLL	Shell32.dll

추가 정보

SHBindToFolderIDListParentEx