IShellFolder::BindToStorage 메서드(shobjidl_core.h)

개체의 스토리지 인터페이스에 대한 포인터를 요청합니다.

구문

HRESULT BindToStorage(
  [in]  PCUIDLIST_RELATIVE pidl,
  [in]  IBindCtx           *pbc,
  [in]  REFIID             riid,
  [out] void               **ppv
);

매개 변수

[in] pidl

형식: PCUIDLIST_RELATIVE

부모 폴더를 기준으로 하위 폴더를 식별하는 ITEMIDLIST 구조체의 주소입니다. 구조체에는 정확히 하나의 SHITEMID 구조체와 종료 0이 있어야 합니다.

[in] pbc

형식: IBindCtx*

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

[in] riid

형식: REFIID

요청된 스토리지 인터페이스의 IID입니다. IStream, IStorage 또는 IPropertySetStorage 인터페이스 포인터를 검색하려면 riid를 각각 IID_IStream, IID_IStorage 또는 IID_IPropertySetStorage 설정합니다.

[out] ppv

형식: void**

riid로 지정된 인터페이스 포인터를 받는 주소입니다. 오류가 발생하면 이 주소에 NULL 포인터가 반환됩니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

네임스페이스 확장에는 애플리케이션이 항목의 스토리지를 나타내는 개체에 바인딩할 수 있는 옵션이 있습니다. 이 옵션이 지원되는 경우 IShellFolder::BindToStorage 는 개체의 내용에 액세스하는 데 사용할 수 있는 지정된 인터페이스 포인터를 반환합니다. 자세한 내용은 IMoniker::BindToStorage 참조를 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)
DLL	Shell32.dll(버전 4.0 이상)