IConnectionPoint::GetConnectionInterface

  • Article

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.

See Also

IConnectionPoint | IConnectionPointContainer::FindConnectionPoint | IEnumConnectionPoints

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.