共用方式為


IConnectionPointContainer::EnumConnectionPoints 方法 (ocidl.h)

建立列舉值物件,逐一查看可連接物件中支援的所有連接點,每個連出 IID 各一個連接點。

語法

HRESULT EnumConnectionPoints(
  [out] IEnumConnectionPoints **ppEnum
);

參數

[out] ppEnum

IEnumConnectionPoints 介面指標變數的指標,可接收新建立之列舉值的指標。

傳回值

這個方法可以傳回標準傳回值E_OUTOFMEMORY和E_UNEXPECTED,以及下列值。

傳回碼 描述
S_OK
已成功建立列舉值物件。
E_POINTER
ppEnum 中的地址無效。 例如,它可能是 NULL

備註

因為 IEnumConnectionPoints 會列舉 IConnectionPoint 的指標,所以呼叫端必須使用 IConnectionPoint::GetConnectionInterface 來判斷連接點所支援之傳出介面的介面標識符。

來電者附註

當不再需要列舉值時,呼叫端會負責呼叫 Release

實作者的注意事項

傳回E_NOTIMPL特別不允許,因為除了類型資訊之外,呼叫者無法透過其他方式找到傳出介面的 IID。 由於可連接的物件通常會有一組固定的已知傳出介面,因此在編譯時期已知 IID 的固定長度陣列之上實作列舉值相當簡單。

規格需求

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

另請參閱

IConnectionPointContainer

IEnumConnectionPoints