IOleAdviseHolder::EnumAdvise 方法 (oleidl.h)
建立列舉值,可用來列舉目前為 物件建立的諮詢連接。
語法
HRESULT EnumAdvise(
[out] IEnumSTATDATA **ppenumAdvise
);
參數
[out] ppenumAdvise
IEnumSTATDATA 指標變數的指標,可接收新列舉值的介面指標。 如果此參數為 NULL,則物件上目前沒有諮詢連線,或發生錯誤。 建議持有者負責遞增這個方法提供的 IEnumSTATDATA 指標上的參考計數。 呼叫者必須負責在完成指標時呼叫 IUnknown::Release 。
傳回值
此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。
傳回碼 | Description |
---|---|
|
列舉作業失敗。 |
|
備註
IOleAdviseHolder::EnumAdvise 會建立列舉值,可用來列舉物件的已建立諮詢連線。 方法會提供這個列舉值上 IEnumSTATDATA 介面的指標。 每個連線的諮詢連接信息都會儲存在 STATDATA 結構中,而且列舉值必須能夠列舉這些結構。
針對這個方法,唯一相關的結構成員是 pAdvise 和 dwConnection。 其他成員包含數據諮詢資訊。 當您呼叫列舉方法,且列舉正在進行時,註冊或撤銷所要列舉專案之諮詢連接的效果是未定義的。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | oleidl.h |