IAxWinAmbientDispatchEx 인터페이스
이 인터페이스는 호스트된 컨트롤에 대한 추가 앰비언트 속성을 구현합니다.
Important
이 클래스와 해당 멤버는 Windows 런타임에서 실행되는 애플리케이션에서 사용할 수 없습니다.
구문
MIDL_INTERFACE("B2D0778B - AC99 - 4c58 - A5C8 - E7724E5316B5") IAxWinAmbientDispatchEx : public IAxWinAmbientDispatch
멤버
메서드
| 속성 | 설명 |
|---|---|
| SetAmbientDispatch | 이 메서드는 기본 앰비언트 속성 인터페이스를 사용자 정의 인터페이스로 보완하기 위해 호출됩니다. |
설명
ATL 및 호스트 ActiveX 컨트롤, 특히 앰비언트 속성이 있는 ActiveX 컨트롤에 정적으로 연결된 ATL 애플리케이션에 이 인터페이스를 포함합니다. 이 인터페이스를 포함하지 않으면 "LIBID를 CComModule::Init에 전달하는 것을 잊은 경우" 어설션이 생성됩니다.
이 인터페이스는 ATL의 ActiveX 컨트롤 호스팅 개체에 의해 노출됩니다. IAxWinAmbientDispatchIAxWinAmbientDispatchEx에서 파생되어 ATL에서 제공하는 앰비언트 속성 인터페이스를 사용자 고유의 인터페이스로 보완할 수 있는 메서드를 추가합니다.
AxHost 는 코드를 포함하는 형식 라이브러리에 대한 IAxWinAmbientDispatch IAxWinAmbientDispatchEx 형식 정보를 로드하려고 합니다.
ATL90.dll 연결하는 경우 AXHost 는 DLL의 형식 라이브러리에서 형식 정보를 로드합니다.
자세한 내용은 ATL AXHost를 사용하여 ActiveX 컨트롤 호스팅을 참조하세요.
요구 사항
이 인터페이스의 정의는 다음 표와 같이 다양한 양식에서 사용할 수 있습니다.
| 정의 형식 | 파일 |
|---|---|
| IDL | atliface.idl |
| 형식 라이브러리 | ATL.dll |
| C++ | atliface.h(ATLBase.h에도 포함) |
IAxWinAmbientDispatchEx::SetAmbientDispatch
이 메서드는 기본 앰비언트 속성 인터페이스를 사용자 정의 인터페이스로 보완하기 위해 호출됩니다.
virtual HRESULT STDMETHODCALLTYPE SetAmbientDispatch(IDispatch* pDispatch) = 0;
매개 변수
pDispatch
새 인터페이스에 대한 포인터입니다.
Return Value
성공 시 S_OK를 반환하거나 실패 시 HRESULT 오류를 반환합니다.
설명
SetAmbientDispatch 새 인터페이스에 대한 포인터를 사용하여 호출되는 경우 이 새 인터페이스는 IAxWinAmbientDispatch에서 해당 속성을 아직 제공하지 않은 경우 호스트된 컨트롤에서 요청하는 모든 속성 또는 메서드를 호출하는 데 사용됩니다.