IDataObject：：EnumDAdvise 方法 (objidl.h)

建立可以用來列舉目前諮詢連接的物件。

語法

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

參數

[out] ppenumAdvise

IEnumSTATDATA 指標變數的指標，可接收新列舉值物件的介面指標。 如果實作將 *ppenumAdvise 設定為 NULL，目前沒有任何連線可建議接收。

傳回值

如果列舉值物件已成功具現化或沒有連接，這個方法會傳回S_OK。 其他可能的值包括下列專案。

傳回碼	Description
E_OUTOFMEMORY	記憶體不足，無法用於作業。
OLE_E_ADVISENOTSUPPORTED	此物件不支持諮詢通知。

備註

這個方法所建立的列舉值物件會實作 IEnumSTATDATA 介面。 IEnumSTATDATA 允許列舉儲存在 STATDATA 結構的陣列中的數據。 這些結構都提供單一諮詢連線的相關信息，並包含 FORMATETC 和 ADVF 資訊，以及建議接收的指標，以及代表連線的令牌。

來電者的附註

建議您使用 OLE 數據建議持有者對象來處理諮詢連線。 透過呼叫 CreateDataAdviseHolder 取得的指標時，實作 IDataObject：：EnumDAdvise 會成為委派 IDataAdviseHolder：：EnumAdvise 呼叫的簡單事項。 這會建立列舉值，並提供 IEnumSTATDATA 之 OLE 實作的指標。 此時，您可以呼叫其方法來列舉目前的諮詢連線。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	objidl.h

另請參閱

IDataAdviseHolder：：EnumAdvise

IDataObject

IEnumSTATDATA