SocketCreate (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Communication

Sockets

WLanguage functions

WLanguage procedure

SocketCreate

Presentation

Example

Re-creating a socket

Re-using an address that is already used

Connecting to an infrared port

Required permissions

Required application feature

See also

SocketCreate (Function)

In french: SocketCrée

Creates a socket. A socket is a communication resource used by applications to communicate from one computer to another regardless of the type of network.

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.

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. If an error occurs, you can get more details on the error with ErrorInfo.

<Socket name>: Character string

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

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 reuse an address already used (by the application itself or by another application). To forbid this operating mode, type the following line of code:

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.

Required permissions

The call to this function modifies the permissions required by the application.
Required permission : INTERNET
This permission allows the applications to open the network sockets.

Required application feature

When this function is used, an application feature is declared 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: wd280com.dll