Solclient
ISessionCreateTransactedSession Method |
Creates a transacted session on the given ISession instance.
If CreateMessageDispatcher is
false, the default Context-bound Message Dispatcher is used by the
transacted session to deliver messages asynchronously to transacted flows.
By enabling CreateMessageDispatcher,
a new transacted-session-bound messge dispatcher is created when the
transacted session creates its first transacted consumer flow with asynchrounous
message delivery.
CreateTransactedSession(TransactedSessionProperties) blocks until a transacted
session is created on the appliance. If HasPublisher
is enabled, it also waits until a default publisher flow is opened properly.
Namespace: SolaceSystems.Solclient.Messaging
Assembly: SolaceSystems.Solclient.Messaging (in SolaceSystems.Solclient.Messaging.dll) Version: 7.2.1.27 (7.2.1.27)
Syntax
ITransactedSession CreateTransactedSession( TransactedSessionProperties props )
Function CreateTransactedSession ( props As TransactedSessionProperties ) As ITransactedSession
ITransactedSession^ CreateTransactedSession( TransactedSessionProperties^ props )
Parameters
- props
- Type: SolaceSystems.Solclient.MessagingTransactedSessionProperties
The transacted session properties
Return Value
Type: ITransactedSessionThe newly created instance of ITransactedSession
Exceptions
Exception | Condition |
---|---|
OperationErrorException | On error, an OperationErrorException is thrown. The exception contains the return code and error subcode (See return code and subcodes.) |
ObjectDisposedException | Thrown when the session is already disposed (terminal state). |
FatalErrorException | Thrown when un-recoverable error occurs. |
ArgumentNullException | Thrown if any of the required parameters is null. |
ArgumentException | Thrown if arguments fail validation. |
See Also