Edit

IConnectionPoint::GetConnectionInterface method (ocidl.h)

  • Article

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

Syntax

HRESULT GetConnectionInterface(
  [out] IID *pIID
);

Parameters

[out] pIID

A pointer to the identifier of the outgoing interface managed by this connection point.

Return value

This method can return the standard return value E_UNEXPECTED, as well as the following values.

Return code Description
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.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps | UWP apps]
Minimum supported server Windows 2000 Server [desktop apps | UWP apps]
Target Platform Windows
Header ocidl.h

See also

IConnectionPoint