TMSServiceBroker.BeginDialog Method

Initiates a dialog from one TMSServiceBroker.Service to another service.

Class

Syntax

function BeginDialog(const TargetService: string; const TargetDatabase: string = ''; const UseEncryption: boolean = True; RelatedConversation: TMSConversation = nil; const LifeTime: integer = 0; const Contract: string = ''): TMSConversation; overload;

Parameters

TargetService

The target service name that the conversation initiates with.

TargetDatabase

Specifies the database name that the target service hosts.

UseEncryption

Specifies whether messages within the conversation must be encrypted. When set to True (the default value), it may require applying additional server settings.

RelatedConversation

Already existing conversation to whose group a new conversation will be added. If this parameter is not set, a new group will be created.

LifeTime

Specifies the maximum time interval (in seconds) while the dialog remains open. After this interval expires, the dialog automatically closes. A zero LifeTime value represents an infinity interval. This is the default value.

Contract

Specifies the name of the contract that the conversation conforms to. If the parameter is not set, the DEFAULT contract is used.

Return Value

a new instance of the TMSConversation class.

Remarks

These overloaded methods initiate a dialog from one TMSServiceBroker.Service to another service. A dialog is a conversation that provides messaging between two services.

Use BeginDialog to create an instance of the TMSConversation class. The new instance will be created with the TMSConversation.IsInitiator property assigned to True.

TMSServiceBroker.BeginDialog Method

Class

Syntax

Remarks

See Also