共用方式為

IOleAdviseHolder：：Advise 方法 (oleidl.h)

  • 發行項

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

語法

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

參數

[in] pAdvise

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

[out] pdwConnection

可傳遞至 IOleAdviseHolder：：Unadvise 方法以刪除諮詢連線的令牌指標。 呼叫對象負責在此指標上呼叫 IUnknown：：AddRef 和 IUnknown：：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：：建議