다음을 통해 공유

SHBindToObject 함수(shlobj_core.h)

  • 아티클

셸 네임스페이스 IShellFolder::BindToObject 메서드를 사용하여 지정된 개체를 검색하고 바인딩합니다.

구문

SHSTDAPI SHBindToObject(
        IShellFolder       *psf,
        PCUIDLIST_RELATIVE pidl,
  [in]  IBindCtx           *pbc,
        REFIID             riid,
  [out] void               **ppv
);

매개 변수

psf

형식: IShellFolder*

IShellFolder에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다. psf가 NULL이면 매개 변수 pidl이 데스크톱을 기준으로 했음을 나타냅니다. 이 경우 pidl 은 절대 ITEMIDLIST를 지정해야 합니다.

pidl

형식: PCUIDLIST_RELATIVE

psf를 기준으로 바인딩할 상수 ITEMIDLIST에 대한 포인터입니다. psf가 NULL인 경우 데스크톱 폴더에 상대적인 절대 ITEMIDLIST입니다.

[in] pbc

형식: IBindCtx*

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

riid

형식: REFIID

반환할 인터페이스의 식별자입니다.

[out] ppv

형식: void**

이 메서드가 반환될 때 는 바인딩된 개체에 대한 riid 에 지정된 인터페이스 포인터를 포함합니다. 오류가 발생하면 에는 NULL 포인터가 포함됩니다.

반환 값

형식: HRESULT

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

설명

참고SHGetDesktopFolder를 호출하여 데스크톱 개체를 가져오는 도우미 함수입니다.
 

요구 사항

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

추가 정보

IShellFolder

IShellFolder::BindToObject