IBindCtx::GetObjectParam 메서드(objidl.h)

아티클
02/29/2024

바인딩 컨텍스트의 문자열 키 테이블 포인터에서 지정된 키와 연결된 개체에 대한 인터페이스 포인터를 검색합니다.

구문

HRESULT GetObjectParam(
  [in]  LPOLESTR pszKey,
  [out] IUnknown **ppunk
);

매개 변수

[in] pszKey

검색할 바인딩 컨텍스트 문자열 키 입니다. 키 문자열 비교는 대/소문자를 구분합니다.

[out] ppunk

pszKey와 연결된 개체에 대한 인터페이스 포인터를 수신하는 IUnknown* 포인터 변수의 주소입니다. 성공하면 구현은 *ppunk에서 AddRef를 호출합니다. 릴리스를 호출하는 것은 호출자의 책임입니다. 오류가 발생하면 구현에서 *ppunk 를 NULL로 설정합니다.

반환 값

메서드가 성공하면 반환 값이 S_OK. 그렇지 않으면 E_FAIL.

설명

바인딩 컨텍스트는 각각 문자열 키와 연결된 인터페이스 포인터 테이블을 유지 관리합니다. 이렇게 하면 모니커 구현과 바인딩 작업을 시작한 호출자 간에 통신할 수 있습니다. 한 당사자는 나중에 바인드 컨텍스트에서 검색할 수 있도록 두 당사자에게 알려진 문자열 아래에 인터페이스 포인터를 저장할 수 있습니다.

이 메서드가 검색하는 포인터는 이전에 IBindCtx::RegisterObjectParam 메서드를 사용하여 테이블에 삽입되어 있어야 합니다.

발신자에게 참고 사항

모니커를 사용하여 다른 개체를 찾는 개체는 바인딩 작업이 발생한 오류에 대한 특정 정보를 얻지 못할 때 이 메서드를 호출할 수 있습니다. 오류에 따라 상황을 수정하고 바인딩 작업을 다시 시도할 수 있습니다. 자세한 내용은 IBindCtx::RegisterObjectParam 을 참조하세요.

모니커 구현은 호출자가 바인딩 작업을 시작하고 특정 정보를 요청하는 상황을 처리하기 위해 이 메서드를 호출할 수 있습니다. 규칙에 따라 구현자는 모니커 클래스의 CLSID 문자열 형식으로 시작하는 키 이름을 사용해야 합니다. ( StringFromCLSID 함수를 참조하세요.)

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	objidl.h

추가 정보

IBindCtx

Share via