IAdviseSink 인터페이스(objidl.h)

아티클
03/05/2024

컨테이너 및 기타 개체가 관심 있는 개체에서 발생하는 데이터 변경 내용, 보기 변경 내용 및 복합 문서 변경에 대한 알림을 받을 수 있도록 합니다. 예를 들어 컨테이너 애플리케이션은 연결된 개체와 포함된 개체의 캐시된 프레젠테이션을 최신 상태로 유지하기 위해 이러한 알림이 필요합니다. IAdviseSink 메서드에 대한 호출은 비동기적이므로 호출이 전송된 다음 호출의 반환을 기다리지 않고 다음 명령이 실행됩니다.

공지 연결이 존재하려면 알림을 받을 개체가 IAdviseSink를 구현해야 하며 관심이 있는 개체는 IOleObject::Advise 및 IDataObject::D Advise를 구현해야 합니다. In-process 개체 및 처리기는 IViewObject::SetAdvise를 구현할 수도 있습니다. IOleObject를 구현하는 개체는 모든 합리적인 권고 방법을 지원해야 합니다. 권고 알림을 간소화하기 위해 OLE는 권고 연결을 추적하고 IAdviseSink 인터페이스에 대한 포인터를 통해 적절한 싱크에 알림을 보내는 IDataAdviseHolder 및 IOleAdviseHolder의 구현을 제공합니다. IViewObject (및 해당 권고 메서드)는 기본 처리기에서 구현됩니다.

다음 표와 같이 advise 싱크를 구현한 개체는 적절한 메서드를 호출하여 특정 유형의 알림을 받는 데 관심을 등록합니다.

이 메서드 호출	이러한 알림을 등록하려면
IOleObject::Advise	문서가 저장, 닫힘 또는 이름이 바뀐 경우
IDataObject::D Advise	문서의 데이터가 변경되는 경우
IViewObject::SetAdvise	문서의 프레젠테이션이 변경되는 경우

등록된 알림 유형에 적용되는 이벤트가 발생하면 개체 애플리케이션은 적절한 IAdviseSink 메서드를 호출합니다. 예를 들어 포함된 개체가 닫히면 IAdviseSink::OnClose 메서드를 호출하여 컨테이너에 알립니다. 이러한 알림은 비동기적이며 트리거하는 이벤트 후에 발생합니다.

상속

IAdviseSink 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IAdviseSink 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IAdviseSink 인터페이스에는 이러한 메서드가 있습니다.


IAdviseSink::OnClose 서버에서 호출하여 등록된 모든 권고 싱크에 개체가 실행 중에서 로드된 상태로 변경되었음을 알립니다.
IAdviseSink::OnDataChange 서버에서 호출하여 데이터 개체의 현재 등록된 알림 싱크에 개체의 데이터가 변경되었음을 알립니다.
IAdviseSink::OnRename 등록된 모든 권고 싱크에 개체 이름이 변경되었음을 알리기 위해 서버에서 호출합니다.
IAdviseSink::OnSave 등록된 모든 권고 싱크에 개체가 저장되었음을 알리기 위해 서버에서 호출합니다.
IAdviseSink::OnViewChange 개체의 등록된 advise 싱크에 보기가 변경되었음을 알 수 있습니다.

요구 사항

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