SHBindToParent 함수(shlobj_core.h)

PIDL(정규화된 항목 식별자 목록)에 대한 포인터를 사용하고 부모 개체에 대해 지정된 인터페이스 포인터를 반환합니다.

구문

SHSTDAPI SHBindToParent(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [in]  REFIID            riid,
  [out] void              **ppv,
  [out] PCUITEMID_CHILD   *ppidlLast
);

매개 변수

[in] pidl

형식: PCIDLIST_ABSOLUTE

항목의 PIDL입니다.

[in] riid

형식: REFIID

항목의 부모 개체에 의해 노출되는 인터페이스 중 하나의 REFIID 입니다.

[out] ppv

형식: VOID**

riid로 지정된 인터페이스에 대한 포인터입니다. 완료되면 개체를 해제해야 합니다.

[out] ppidlLast

형식: PCUITEMID_CHILD*

부모 폴더를 기준으로 하는 항목의 PIDL입니다. 이 PIDL은 부모 폴더의 인터페이스에서 지원하는 많은 메서드와 함께 사용할 수 있습니다. ppidlLast를 NULL로 설정하면 PIDL이 반환되지 않습니다.

참고SHBindToParent 는 새 PIDL을 할당하지 않습니다. 이 매개 변수를 통해 포인터를 수신하기만 하면 됩니다. 따라서 이 리소스를 해제할 책임이 없습니다.

 

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 성공하지 않으면 HRESULT 오류 코드를 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlobj_core.h(Shlobj.h 포함)
라이브러리	Shell32.lib
DLL	Shell32.dll(버전 5.0 이상)