|
Callback for a DOFConnection when connect-level interests and matching providers indicate that a streaming connection is desired.
This callback may indicate to a datagram (or any non-stream) connection that it should "upgrade" itself to a streaming connection (to the same host). This callback may indicate to a stream connection that the connection is still desired. This call is responsible for establishing or maintaining the streaming connection, if possible.
This callback may be NULL to ignore notification of this condition.
- Parameters
-
self | The listener object. This will never be NULL. |
config | The DOFConnectionConfig on which the listener was set. In addition, this contains the valid security information assocaited with the existing connection so that a compatible streaming connection can be made. This will never be NULL. |
request | An object representing the request for a sreaming connection. This will never be NULL. This request includes the following information: # The DOFConnection on which the request is being made. This connection instance is unique to the request/listener (it is not the same DOFConnection the application has, but it represents the same underlying connection). This also gives access to the current connection state, useful for determining if the request is on a datagram connection (for which a stream connection should be opened) or on a stream connection (which needs to be kept open, and possibly monitored, to satisfy the request). # The DOFAddress representing the address to which to connect. In some cases, the address associated with the connection (and its configuration) may not be appropriate for opening a streaming connection (e.g., a multicast, broadcast, or group address); this parameter is always a unicast address, and is always the correct address to which to connect. |
|