TCPBind

Command group Flag affected Reversible Execute on client Platform(s)
External commands YES NO NO All

Syntax

TCPBind (socket,service|portReturns status

Description

Note: The flag is set according to whether Omnis was able to make a call to this external command.

This Web command is multi-threaded, allowing another thread to execute in the multi-threaded server while it runs. Note that the same socket cannot safely be used concurrently by more than one thread.

TCPBind binds a socket created with TCPSocket to a particular local port.

Socket is an Omnis Long Integer field, containing the number of the socket.

Service/Port is either an Omnis integer field containing the number of the port to which the socket should be bound, or an Omnis character field containing the name of a service which will be resolved to a port number by a local lookup.

Status is an Omnis Long Integer field which receives the value zero for success, or an error code < 0 for failure. Possible error codes are listed in the Web Command Error Codes Appendix.

Example

; Get the next available socket and bind it to port iPort
Calculate iPort as 6000
TCPSocket Returns iSocket
TCPBind (iSocket,iPort) Returns lStatus