SHBindToFolderIDListParentEx 함수(shlobj_core.h)

호출자가 바인딩 컨텍스트를 지정할 수 있도록 하여 SHBindToFolderIDListParent 함수를 확장합니다.

구문

SHSTDAPI SHBindToFolderIDListParentEx(
  [in, optional]  IShellFolder       *psfRoot,
  [in]            PCUIDLIST_RELATIVE pidl,
  [in, optional]  IBindCtx           *ppbc,
  [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, optional] ppbc

형식: IBindCtx*

이 작업 중에 사용할 바인딩 컨텍스트 개체의 IBindCtx 인터페이스에 대한 포인터입니다. 이 매개 변수를 사용하지 않는 경우 SHBindToFolderIDListParent 함수를 호출하는 것과 동일한 NULL로 설정합니다. pbc에 대한 지원은 폴더 개체 구현에 대한 선택 사항이므로 일부 폴더는 바인딩 컨텍스트 사용을 지원하지 않을 수 있습니다.

[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 오류 코드를 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlobj_core.h(Shlobj.h 포함)
DLL	Shell32.dll

추가 정보

SHBindToFolderIDListParent