共用方式為

IDataAdviseHolder：：SendOnDataChange 方法 (objidl.h)

  • 發行項

針對目前由建議持有者對象這個實例處理的每個建議接收，傳送通知給每個建議接收，呼叫 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。 唯一的例外狀況是在關閉數據物件時發生，而且必須傳送最終通知，其中包含實際數據給已指定ADVF_DATAONSTOP的接收，並在其呼叫 IDataObject：:D Advise 時ADVF_NODATA。 在此情況下， advf 包含ADVF_DATAONSTOP。

傳回值

此方法會在成功時傳回S_OK。

備註

當數據物件偵測到先前要求通知的建議接收有興趣的變更時，數據對象必須呼叫這個方法。

大部分的通知都包含實際數據。 唯一的例外狀況是，如果先前在 IDataAdviseHolder：：Advisor 方法中設定連線時指定了ADVF_NODATA旗標。

針對每個建議接收呼叫 IAdviseSink：：OnDataChange 方法之前，此方法會透過 pDataObject 參數中指定的指標呼叫 IDataObject：：GetData 方法，以取得實際數據。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 objidl.h

另請參閱

IAdviseSink：：OnDataChange

IDataAdviseHolder