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,以及下列值。
傳回碼 | 描述 |
---|---|
|
已成功完成命令。 |
|
ppCP 中的地址無效。 例如,可能是 NULL。 |
|
這個可連接的物件不支援 riid所指定的傳出介面。 |
備註
此方法是對象傳出介面的 QueryInterface 對等專案,其中傳出介面是以 riid 指定,而傳回的介面指標一律是連接點的介面。
來電者的附註
如果呼叫成功,呼叫端會負責在不再需要連接點時呼叫 Release 來釋放連接點。實作者的注意事項
E_NOTIMPL不允許做為這個方法的傳回值。 IConnectionPointContainer 的任何實作都必須針對可連接對象的傳出介面實作這個方法。規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | ocidl.h |