IConnectionPoint-class {RDCOMEvents}R Documentation

S reference to a COM event source, aka Connection Point

Description

The IConnectionPoint class is used to represent the objects with which one can register event handlers in R to DCOM event sources. Such objects are references to COM objects that fire events to interested parties. We use this data type when registering an event handler with such a COM object via connectConnectionPoint

The IExpandedConnectionPoint is a derived class that is intended to contain additional information that makes the connection point self-describing for the purposes of use in other S functions. It contains a reference to the DCOM object from which the connection point was retrieved. It also contains the UUID of the interface that an event handler must implement to register for events from that source.

Objects from the Class

One does not create IConnectionPoint objects manually. Instead, one must obtain them via the functions getConnectionPoints and findConnectionPoint.

Slots

ref:
Object of class "externalptr", from class "IUnknown" This is the reference to the COM object which represents the event source.
source:
Object of class "COMIDispatch". This is the object used to query the connection point. It is essentially the host of the connection point. This can be used to find the type library that provides descriptions about the interface that is expected for event sinks/handlers for this connection point.
guid:
Object of class "character" This is the identifier for the interface that the event handler must implement to listen for events from this source/connection point. One can use this information to find the definition of the interface within the type library associated with the source of the connection point, i.e. the value of the source slot.

Extends

Class "IUnknown", directly.

Methods

No methods defined with class "IConnectionPoint" in the signature.

Author(s)

Duncan Temple Lang (duncan@wald.ucdavis.edu)

References

http://www.omegahat.org/RDCOMClient http://www.omegahat.org/RDCOMServer http://www.omegahat.org/SWinTypeLibs http://www.omegahat.org/SWinRegistry

See Also

connectConnectionPoint getConnectionPoints findConnectionPoint COMIDispatch-class

Examples



[Package RDCOMEvents version 0.3-1 Index]