IDataAdviseHolder::SendOnDataChange 메서드(objidl.h)

현재 자문 소유자 개체의 이 instance 처리 중인 각 조언 싱크에 대해 IAdviseSink::OnDataChange 메서드를 호출하여 설정된 연결이 있는 각 조언 싱크에 알림을 보냅니다.

구문

HRESULT SendOnDataChange(
  [in] IDataObject *pDataObject,
  [in] DWORD       dwReserved,
  [in] DWORD       advf
);

매개 변수

[in] pDataObject

데이터가 방금 변경된 데이터 개체의 IDataObject 인터페이스에 대한 포인터입니다. 이 포인터는 IAdviseSink::OnDataChange에 대한 후속 호출에 사용됩니다.

[in] dwReserved

이 매개 변수는 예약되어 있으며 0이어야 합니다.

[in] advf

IAdviseSink::OnDataChange 호출을 수행하는 방법을 지정하는 조언 플래그용 컨테이너입니다. 이러한 플래그 값은 열거형 ADVF에서 가져옵니다. 일반적으로 advf 의 값은 NULL입니다. 유일한 예외는 데이터 개체가 종료될 때 발생하며 IDataObject::D Advise를 호출할 때 ADVF_DATAONSTOP 지정하고 ADVF_NODATA 싱크에 실제 데이터를 포함하는 최종 알림을 보내야 합니다. 이 경우 advf 에는 ADVF_DATAONSTOP 포함됩니다.

반환 값

이 메서드는 성공에 대한 S_OK 반환합니다.

설명

데이터 개체는 이전에 알림을 요청한 조언 싱크에 관심이 있는 변경 사항을 감지할 때 이 메서드를 호출해야 합니다.

대부분의 알림에는 실제 데이터가 포함됩니다. 유일한 예외는 연결이 IDataAdviseHolder::Advise 메서드에서 처음 설정되었을 때 이전에 ADVF_NODATA 플래그를 지정한 경우입니다.

각 advise 싱크에 대해 IAdviseSink::OnDataChange 메서드를 호출하기 전에 이 메서드는 pDataObject 매개 변수에 지정된 포인터를 통해 IDataObject::GetData 메서드를 호출하여 실제 데이터를 가져옵니다.

요구 사항

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

추가 정보

IAdviseSink::OnDataChange

IDataAdviseHolder