ISession.CreateFlow Method (FlowProperties, IEndpoint, ISubscription, EventHandler(MessageEventArgs), EventHandler(FlowEventArgs), EndpointProperties)

Solclient

previous page next page

Solclient

ISessionCreateFlow Method (FlowProperties, IEndpoint, ISubscription, EventHandlerMessageEventArgs, EventHandlerFlowEventArgs, EndpointProperties)

version: 7.2.1.27

Creates IFlow instances. In addition, if endPoint is a non-durable Endpoint, it is possible to specify the EndpointProperties of implicitly created Endpoint on the appliance.

The message receive delegate is invoked for each received message on this flow. The flow event delegate is invoked when flow events occur, such as the flow going up or down. Both delegates are invoked in the context of the context thread to which this session belongs.

Note: disposing the corresponding context (IContext) or any of its contained context timers (TimerTask), sessions (ISession) or flows (IFlow) must not be performed from within the registered delegates (messageEventHandler or flowEventHandler).

Namespace: SolaceSystems.Solclient.Messaging
Assembly: SolaceSystems.Solclient.Messaging (in SolaceSystems.Solclient.Messaging.dll) Version: 7.2.1.27 (7.2.1.27)

Syntax

C++

Copy

IFlow CreateFlow(
	FlowProperties flowProperties,
	IEndpoint endPoint,
	ISubscription subscription,
	EventHandler<MessageEventArgs> messageEventHandler,
	EventHandler<FlowEventArgs> flowEventHandler,
	EndpointProperties endPointProperties
)

Function CreateFlow ( 
	flowProperties As FlowProperties,
	endPoint As IEndpoint,
	subscription As ISubscription,
	messageEventHandler As EventHandler(Of MessageEventArgs),
	flowEventHandler As EventHandler(Of FlowEventArgs),
	endPointProperties As EndpointProperties
) As IFlow

IFlow^ CreateFlow(
	FlowProperties^ flowProperties, 
	IEndpoint^ endPoint, 
	ISubscription^ subscription, 
	EventHandler<MessageEventArgs^>^ messageEventHandler, 
	EventHandler<FlowEventArgs^>^ flowEventHandler, 
	EndpointProperties^ endPointProperties
)

Parameters

flowProperties: Type: SolaceSystems.Solclient.MessagingFlowProperties
FlowProperties
endPoint: Type: SolaceSystems.Solclient.MessagingIEndpoint
The IEndpoint instance to bind the new IFlow to.
subscription: Type: SolaceSystems.Solclient.MessagingISubscription
Only valid if endpoint is of type ISubscriberEndpoint.
messageEventHandler: Type: SystemEventHandlerMessageEventArgs
The message EventHandler delegate.
flowEventHandler: Type: SystemEventHandlerFlowEventArgs
The flow event EventHandler delegate.
Client applications can call GetLastSDKErrorInfo from within the flow event delegate to get more info on the type of error condition reported by FlowEventArgs.
endPointProperties: Type: SolaceSystems.Solclient.MessagingEndpointProperties
the EndpointProperties of the implicitly created Endpoint on the appliance, endPoint must be durable, otherwise these properties are ignored. Use null to accept default properties.

Return Value

Type: IFlow
An IFlow instance that is already started, unless FlowStartState is set to false.

Exceptions

Exception	Condition
OperationErrorException	Thrown when the operation fails. Possible sub-codes: Timeout CommunicationError OutOfResources InvalidSessionOperation InvalidTopicNameForTE UnknownQueueName UnknownTEName MaxClientsForQueueReached MaxClientsForTEReached QueueNotFound QueueShutdown NoMoreNonDurableQueueOrTE
ObjectDisposedException	Thrown when the session is already disposed (terminal state).
FatalErrorException	Thrown when an unrecoverable error occurs.
ArgumentNullException	Thrown if any of the required parameters is null.
ArgumentException	Thrown if arguments fail validation.

Reference

ISession Interface

CreateFlow Overload

SolaceSystems.Solclient.Messaging Namespace

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to use and copy the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

UNLESS STATED ELSEWHERE BETWEEN YOU AND SOLACE SYSTEMS, INC., THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Send comments on this topic to [email protected]

previous page start next page