IConnectionPoint::GetConnectionPointContainer

  • Article

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

HRESULT GetConnectionPointContainer(
  IConnectionPointContainer** ppCPC 
);

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

OS Versions: Windows CE 3.0 and later.
Header: Ocidl.h, Ocidl.idl.
Link Library: Ole32.lib, Uuid.lib.

See Also

IConnectionPoint | IConnectionPointContainer

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.