IConnectionPointContainer：：FindConnectionPoint 方法 (ocidl.h)

  • 發行項

如果該 IID 描述支援的傳出介面，則會傳回指定 IID 之連接點 之 IConnectionPoint 介面的指標。

語法

HRESULT FindConnectionPoint(
  [in]  REFIID           riid,
  [out] IConnectionPoint **ppCP
);

參數

[in] riid

要求連接點對象的傳出介面標識碼。

[out] ppCP

IConnectionPoint 介面指標變數的位址，可接收支援 riid 介面之連接點的指標。 如果發生錯誤，實作會將值設定為 NULL。

傳回值

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

傳回碼 描述
S_OK
 已成功完成命令。
E_POINTER
 ppCP 中的地址無效。 例如，可能是 NULL。
CONNECT_E_NOCONNECTION
 這個可連接的物件不支援 riid所指定的傳出介面。

備註

此方法是對象傳出介面的 QueryInterface 對等專案，其中傳出介面是以 riid 指定，而傳回的介面指標一律是連接點的介面。

來電者的附註

如果呼叫成功，呼叫端會負責在不再需要連接點時呼叫 Release 來釋放連接點。

實作者的注意事項

E_NOTIMPL不允許做為這個方法的傳回值。 IConnectionPointContainer 的任何實作都必須針對可連接對象的傳出介面實作這個方法。

規格需求

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

另請參閱

IConnectionPoint

IConnectionPointContainer