SocketCreate (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Re-creating a socket
Re-using an address that is already used
Connecting to an infrared port
Required application feature

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

SocketCreate (Function)

In french: SocketCrée

Creates a socket. A socket is a communication resource used by the applications to communicate between computers regardless of the network type.

Remarks:

This function must be called on the server used for the communication. If the client computer is using a WINDEV application to connect to this socket, this application will have to use SocketConnect.
SSL sockets: To create an SSL socket, use SocketCreateSSL.
UDP sockets: To create a UDP socket, use SocketCreateUDP.

Versions 23 and later

This function is now available in Universal Windows 10 App mode.

New in version 23

This function is now available in Universal Windows 10 App mode.

Example

See additional examples

IF SocketCreate("Server", 8000) = False THEN
Error("creation error" + ErrorInfo(errMessage))
END

Syntax

<Result> = SocketCreate(<Socket name> , <Port number> [, <Address>])

<Result>: Boolean

True if the function was successful,
False otherwise. To find out the error details, use ErrorInfo.

<Socket name>: Character string (with quotes)

Name that will be given to the socket. This name will be used by all socket functions. Caution: the socket name is case sensitive.

<Port number>: Integer

Port number that will be given to the socket. This number must be included between 1 and 65000. This number will be specified when the client computers are connected to the server.
You must be "root" to create a socket on a port less than or equal to 1024 (being "root" means being the user who has all the permissions on the system).

<Address>: Optional character string (with quotes)

IP address on which the socket must be created on the current computer. If the current computer is associated with several IP addresses (or with several network cards), this parameter enables you to choose the IP address that will be associated with the socket.
This IP address can have the following format:
IP address in XXX.XXX.XXX.XXX format (125.5.110.100 for example).
IP address containing the name of the server (www.WINDEV.com for example). This syntax is recommended.
The IP address is also returned by NetIPAddress.

Remarks

Re-creating a socket

If a socket is not closed properly by SocketClose (restarting the computer for example), re-creating the socket may take quite a long time. Indeed, you will have to wait until the socket is freed by the system.

Re-using an address that is already used

By default, SocketCreate allows you to re-use an address that is already used (by the application itself or by another application). To forbid this operating mode, type the following code line:

Socket.Option = SocketNoReuseAddress

Remark: Therefore, this option allows you to find out whether an address or a port is already used. In this case, SocketCreate returns an error.

Connecting to an infrared port

To connect to a socket that is using an infrared port:

Create a socket using the infrared port on the server (SocketCreateInfrared in a WINDEV application).
In the client application (WINDEV application), use SocketConnectInfrared to connect to this socket.

Versions 23 and later

Required application feature

The use of this function triggers the declaration of one application feature in the application generation wizard.

Required feature: Family and corporate networks

This feature allows the applications to use incoming and outgoing accesses to the family and corporate networks.

New in version 23

Required application feature

The use of this function triggers the declaration of one application feature in the application generation wizard.

Required feature: Family and corporate networks

This feature allows the applications to use incoming and outgoing accesses to the family and corporate networks.

Required application feature

The use of this function triggers the declaration of one application feature in the application generation wizard.

Required feature: Family and corporate networks

This feature allows the applications to use incoming and outgoing accesses to the family and corporate networks.

Component: wd260com.dll