Back to product page

Blocking property


Determines if methods are blocking.

Type

Boolean

Syntax

  • Basic
object.Blocking [= value]
The Blocking(object,value) syntax has these parts:
objectAn expression evaluating to an object of type wodXMPP
valueA Boolean value.

Remarks

Available only in COM object (invisible DLL) version!

Blocking mode is ideal for scripting environments where you cannot use asynchronous connections. Although events are still fired, you can just ignore them and check to see if an error occurred during method execution.

The difference between blocking and non-blocking operation may be shown using the Connect method:
If Blocking is set to True, wodXMPP will wait until it actually connects with the remote server. Once connected, control will be given back to your program and you can continue with its execution. If an error is generated, control will be returned immediately.

If Blocking is set to False, wodXMPP will immediately return after Connect is called, whether it managed to connect with the remote server (at that particular moment) or not. Following the call to connect, you should wait for the Connected or Disconnected event to determine if Connect was successful or not.

The above applies also to all methods used in wodXMPP (such as SendMessage, SendText...). If an error occurs, it will be returned when the method finishes.

Platforms

Windows