IConnectionPoint::GetConnectionInterface
A version of this page is also available for
4/8/2010
This method returns the IID of the outgoing interface managed by this connection point.
Syntax
HRESULT GetConnectionInterface(
IID* pIID
);
Parameters
- pIID
[out] Pointer to the identifier of the outgoing interface managed by this connection point.
Return Value
This method supports the standard return value E_UNEXPECTED, as well as the following:
- S_OK
The caller's variable pIID contains the identifier of the outgoing interface managed by this connection point.
- E_POINTER
The address in pIID is not valid. For example, it can be NULL.
Remarks
Using the IEnumConnectionPoints interface, a client can obtain a pointer to the IConnectionPoint interface. Using that pointer and the GetConnectionInterface method, the client can determine the IID of each connection point enumerated.
The IID returned from this method must enable the caller to access this same connection point through IConnectionPointContainer::FindConnectionPoint.
To determine whether the platform supports this interface, see Determining Supported COM APIs.
Notes to Implementers
This method must be implemented in any connection point; E_NOTIMPL is not an acceptable return value.
Requirements
| Header | ocidl.h, ocidl.idl |
| Library | ole32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
IConnectionPoint
IConnectionPointContainer::FindConnectionPoint
IEnumConnectionPoints