IOleObject::EnumAdvise 方法 (oleidl.h)
擷取列舉值指標,可用來列舉為對象註冊的諮詢連線,讓容器知道關閉之前要釋放的內容。
語法
HRESULT EnumAdvise(
[out] IEnumSTATDATA **ppenumAdvise
);
參數
[out] ppenumAdvise
接收列舉值物件介面指標的 IEnumSTATDATA 指標變數位址。 如果對象沒有任何諮詢連線,或發生錯誤,則實作必須將 ppenumAdvise 設定為 NULL。 每次物件收到 成功呼叫 IOleObject::EnumAdvise 時,都必須增加 ppenumAdvise 上的參考計數。 呼叫者負責在 ppenumAdvise完成時呼叫 Release。
傳回值
此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。
傳回碼 | Description |
---|---|
|
備註
IOleObject::EnumAdvise 方法提供列舉值,讓容器能夠追蹤為其物件註冊的諮詢連線。 容器通常會呼叫此函式,以便指示對象在關閉之前釋放其每個諮詢連線。
您可以透過 IOleObject::EnumAdvise 存取的列舉值會列舉 STATDATA 類型的專案。 在收到指標時,容器接著可以迴圈執行 STATDATA ,並針對每個列舉的連接呼叫 IOleObject::Unadvise 。
實作此函式的一般方式是將呼叫委派給 IOleAdviseHolder 介面。 只有 STATDATA 的 pAdvise 和 dwConnection 成員與 IOleObject::EnumAdvise 相關。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | oleidl.h |