共用方式為


IOleObject::EnumAdvise 方法 (oleidl.h)

擷取列舉值指標,可用來列舉為對象註冊的諮詢連線,讓容器知道關閉之前要釋放的內容。

語法

HRESULT EnumAdvise(
  [out] IEnumSTATDATA **ppenumAdvise
);

參數

[out] ppenumAdvise

接收列舉值物件介面指標的 IEnumSTATDATA 指標變數位址。 如果對象沒有任何諮詢連線,或發生錯誤,則實作必須將 ppenumAdvise 設定為 NULL。 每次物件收到 成功呼叫 IOleObject::EnumAdvise 時,都必須增加 ppenumAdvise 上的參考計數。 呼叫者負責在 ppenumAdvise完成時呼叫 Release。

傳回值

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

傳回碼 Description
E_NOTIMPL

未實作 IOleObject::EnumAdvise

備註

IOleObject::EnumAdvise 方法提供列舉值,讓容器能夠追蹤為其物件註冊的諮詢連線。 容器通常會呼叫此函式,以便指示對象在關閉之前釋放其每個諮詢連線。

您可以透過 IOleObject::EnumAdvise 存取的列舉值會列舉 STATDATA 類型的專案。 在收到指標時,容器接著可以迴圈執行 STATDATA ,並針對每個列舉的連接呼叫 IOleObject::Unadvise

實作此函式的一般方式是將呼叫委派給 IOleAdviseHolder 介面。 只有 STATDATApAdvisedwConnection 成員與 IOleObject::EnumAdvise 相關。

規格需求

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

另請參閱

IOleObject

IOleObject::建議

IOleObject::Unadvise