IDataObject::EnumDAdvise 方法 (objidl.h)
建立可以用來列舉目前諮詢連接的物件。
語法
HRESULT EnumDAdvise(
[out] IEnumSTATDATA **ppenumAdvise
);
參數
[out] ppenumAdvise
IEnumSTATDATA 指標變數的指標,可接收新列舉值物件的介面指標。 如果實作將 *ppenumAdvise 設定為 NULL,目前沒有任何連線可建議接收。
傳回值
如果列舉值物件已成功具現化或沒有連接,這個方法會傳回S_OK。 其他可能的值包括下列專案。
傳回碼 | Description |
---|---|
|
記憶體不足,無法用於作業。 |
|
此物件不支持諮詢通知。 |
備註
這個方法所建立的列舉值物件會實作 IEnumSTATDATA 介面。 IEnumSTATDATA 允許列舉儲存在 STATDATA 結構的陣列中的數據。 這些結構都提供單一諮詢連線的相關信息,並包含 FORMATETC 和 ADVF 資訊,以及建議接收的指標,以及代表連線的令牌。
來電者的附註
建議您使用 OLE 數據建議持有者對象來處理諮詢連線。 透過呼叫 CreateDataAdviseHolder 取得的指標時,實作 IDataObject::EnumDAdvise 會成為委派 IDataAdviseHolder::EnumAdvise 呼叫的簡單事項。 這會建立列舉值,並提供 IEnumSTATDATA 之 OLE 實作的指標。 此時,您可以呼叫其方法來列舉目前的諮詢連線。規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | objidl.h |