SocketWaitForConnection (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Required permissions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

SocketWaitForConnection (Function)

In french: SocketAttendConnexion

Run on the server, this function is used to wait for a connection request coming from the client sockets.

Remarks:

If the client computer is using a WINDEV application to connect to this socket, the connection request is performed by SocketConnect.
UDP socket: SocketWaitForConnection cannot be used with UDP sockets.

To use the sockets on the server, check "Allow server sockets" in the "Advanced" tab of the WEBDEV administrator.

Versions 15 and later

This function is now available for Android applications.

New in version 15

This function is now available for Android applications.

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

Versions 18 and later

This function is now available in Android widget mode.

New in version 18

This function is now available in Android widget mode.

Versions 19 and later

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

This function is now available for iPhone/iPad applications.

New in version 19

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

This function is now available for iPhone/iPad applications.

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

This function is now available for iPhone/iPad applications.

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

// Creates a socket on the server
IF SocketCreate("Server", 8000) = False THEN
Error("Creation error " + ErrorInfo(errMessage))
ELSE
// Manage the connections of the client computers in a thread
ThreadExecute("Thread1", threadNormal, WaitProcedure)
END

INTERNAL PROCEDURE WaitProcedure()
IF SocketWaitForConnection("Server") THEN
Channel is string
// If the connection is accepted,
// this connection is managed in a specific thread
Channel = SocketAccept("Server")
ThreadExecute(Channel, threadNormal, ProcedureManagement, Channel)
ELSE
IF NOT SocketExist("Server") THEN
BREAK
END
END
END

Syntax

<Result> = SocketWaitForConnection(<Socket name> [, <Maximum timeout>])

<Result>: Boolean

True: a new request for connection is pending.
False: no request for connection was detected.

<Socket name>: Character string

Name of the server socket that waits for the connection.
Caution: The socket name is case sensitive.

<Maximum timeout>: Optional integer or optional Duration

Maximum timeout (in milliseconds).
This function is a blocking function during the specified duration or until a connection request is detected.
If this parameter is not specified, the function locks the application until the next attempt to connect.
Remark: if this function is used in multi-thread mode, the function only locks the thread in which it is called.
This parameter can correspond to:
an integer corresponding to the number of milliseconds,
a Duration variable,
Versions 23 and later
the duration in a readable format (e.g., 1 s or 10 ms).
New in version 23
the duration in a readable format (e.g., 1 s or 10 ms).
the duration in a readable format (e.g., 1 s or 10 ms).

Remarks

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.

Component: wd270com.dll