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

아티클
03/02/2024

일반적으로 특정 항목에 대해 IShellFolder 를 구현하는 Shell 폴더 개체인 처리기를 검색합니다. 처리기의 생성을 제어하는 선택적 매개 변수는 바인딩 컨텍스트에서 전달됩니다.

구문

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

매개 변수

[in] pidl

형식: PCUIDLIST_RELATIVE

하위 폴더를 식별하는 PIDL( ITEMIDLIST 구조체)의 주소입니다. 이 값은 네임스페이스 계층 구조의 부모 폴더 아래의 모든 수준에서 항목을 참조할 수 있습니다. 구조체에는 하나 이상의 SHITEMID 구조체와 NULL 종료가 차례로 포함됩니다.

[in] pbc

형식: IBindCtx*

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

바인딩 컨텍스트에서 제공할 수 있는 정보에는 스트림 처리기에 바인딩할 때 액세스 모드를 나타내는 grfMode 멤버를 포함하는 BIND_OPTS 구조가 포함됩니다. IBindCtx::RegisterObjectParam 및 IBindCtx::GetObjectParam을 사용하여 다른 매개 변수를 설정하고 검색할 수 있습니다.

[in] riid

형식: REFIID

반환할 인터페이스의 식별자입니다. IID_IShellFolder, IID_IStream 또는 특정 처리기를 식별하는 다른 인터페이스일 수 있습니다.

[out] ppv

형식: void**

이 메서드가 반환되면 요청된 인터페이스에 대한 포인터의 주소가 포함됩니다. 오류가 발생하면 이 주소에 NULL 포인터가 반환됩니다.

반환 값

형식: HRESULT

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

설명

애플리케이션은 IShellFolder::BindToObject(..., IID_IShellFolder, ...) 를 사용하여 하위 항목에 대한 Shell 폴더 개체를 가져옵니다. 클라이언트는 특정 처리기를 식별하는 데 사용되는 정식 인터페이스 IID를 전달해야 합니다. 예를 들어 IID_IShellFolder 폴더 처리기를 식별하고 IID_IStream 스트림 처리기를 식별합니다. 구현은 IID_IShellFolder2 같은 파생 인터페이스를 사용하는 처리기에 대한 바인딩도 지원할 수 있습니다. Shell 네임스페이스 확장은 지정된 하위 항목에 대한 Shell 폴더 개체를 만든 다음 QueryInterface 를 호출하여 인터페이스 포인터를 통해 개체와 통신하여 이 함수를 구현할 수 있습니다.

BindToObject 구현은 지원하지 않는 IID 값에 대해 신속하게 실패하여 호출을 최적화할 수 있습니다. 예를 들어 하위 항목의 Shell 폴더 개체가 IRemoteComputer를 지원하지 않는 경우 구현은 하위 항목에 대한 Shell 폴더 개체를 불필요하게 만든 다음 IRemoteComputer가 결국 지원되지 않는 것을 찾는 대신 즉시 E_NOINTERFACE 반환해야 합니다.

요구 사항

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