IConnectionPoint::GetConnectionInterface

Article
06/30/2006

This method returns the IID of the outgoing interface managed by this connection point.

HRESULT GetConnectionInterface(
  IID* pIID 
);

Parameters

pIID
[out] Pointer to the identifier of the outgoing interface managed by this connection point.

Return Values

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

OS Versions: Windows CE 3.0 and later.
Header: Ocidl.h, Ocidl.idl.
Link Library: Ole32.lib, Uuid.lib.

Share via