IConnectionPoint::GetConnectionPointContainer

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method retrieves the IConnectionPointContainer interface pointer for the parent connectable object.

Syntax

HRESULT GetConnectionPointContainer(
  IConnectionPointContainer** ppCPC 
);

Parameters

• ppCPC
  [out] Address of IConnectionPointContainer* pointer variable that receives the interface pointer to the parent connectable object.

Return Value

This method supports the standard return value E_UNEXPECTED, as well as the following:

• S_OK
  The IConnectionPointContainer pointer was successfully returned.

• E_POINTER
  The value in ppCPC is not a valid interface pointer. For example, it can be NULL.

Remarks

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Notes to Callers

This method calls IConnectionPointContainer::AddRef. The caller is responsible for calling IConnectionPointContainer::Release to release this pointer when done.

Notes to Implementers

This method must call IConnectionPointContainer::AddRef before returning.

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

Requirements

See Also

Reference

IConnectionPoint
IConnectionPointContainer