IConnectionPoint::GetConnectionInterface

Returns the IID of the outgoing interface managed by this connection point.

HRESULT GetConnectionInterface(
  IID *pIID  //Pointer to an IID variable
);
 

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 may 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.

Notes to Implementers

This method must be implemented in any connection point; E_NOTIMPL is not an acceptable return value.

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in ocidl.h.

See Also

IConnectionPoint, IConnectionPointContainer::FindConnectionPoint, IEnumConnectionPoints