IConnectionPoint::GetConnectionPointContainer

Retrieves the IConnectionPointContainer interface pointer for the parent connectable object.

HRESULT GetConnectionPointContainer(
  IConnectionPointContainer **ppCPC  
                  //Address of output variable that receives
                  // the IConnectionPointContainer interface pointer
);

Parameters

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

Return Values

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

Remarks

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.

QuickInfo

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