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 오류 코드를 반환합니다.
설명
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | shlobj_core.h(Shlobj.h 포함) |
DLL | Shell32.dll |