IConnectionPoint::GetConnectionInterface

A version of this page is also available for

Windows Embedded CE 6.0 R3

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

See Also

Reference

IConnectionPoint
IConnectionPointContainer::FindConnectionPoint
IEnumConnectionPoints