共用方式為


IOleAdviseHolder::Advise 方法 (oleidl.h)

建立 OLE 對象與呼叫物件建議接收之間的諮詢連線。 透過該接收,當 OLE 物件重新命名、儲存或關閉時,呼叫物件可以接收通知。

語法

HRESULT Advise(
  [in]  IAdviseSink *pAdvise,
  [out] DWORD       *pdwConnection
);

參數

[in] pAdvise

通知接收上應通知變更之 IAdviseSink 介面的指標。

[out] pdwConnection

可傳遞至 IOleAdviseHolder::Unadvise 方法以刪除諮詢連線的令牌指標。 呼叫對象負責在此指標上呼叫 IUnknown::AddRefIUnknown::Release

傳回值

此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。

傳回碼 Description
E_INVALIDARG
提供的 IAdviseSink 介面指標無效。

備註

容器、對象處理程式和鏈接物件都會建立建議接收,以接收相關複合檔物件變更的通知,例如內嵌或連結的物件。 這些物件感興趣的 OLE 對象必須實作 IOleObject 介面,其中包含數個諮詢方法,包括 IOleObject::Advisor。 呼叫這個方法時,必須設定與任何建議接收的諮詢連線,以呼叫它,並維護每個連線,直到關閉為止。 它必須能夠一次處理多個諮詢連線。

IOleAdviseHolder::Advise 旨在用來簡化 IOleObject::Advise 的實作。 您可以藉由呼叫 CreateOleAdviseHolder 來取得 IOleAdviseHolder 的 OLE 實作指標,然後,若要實作 IOleObject::Advise,只要將呼叫委派給 IOleAdviseHolder::Advise 即可。 其他 IOleAdviseHolder 方法旨在實作其他 IOleObject 諮詢方法。

如果嘗試建立諮詢連線成功,接收呼叫的物件會透過 pdwConnection 傳回非零值。 如果嘗試失敗,對象會傳回零。 若要刪除諮詢連線,具有建議接收的物件會藉由呼叫 IOleAdviseHolder::Advisor,將此非零令牌傳回物件。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 oleidl.h

另請參閱

IOleAdviseHolder

IOleAdviseHolder::EnumAdvise

IOleAdviseHolder::Unadvise

IOleObject::建議