SocketWaitForConnection (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

This content comes from an automatic translation.

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 the UDP sockets.

To use the sockets on the server, check "Allow the 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 the applications to communicate between computers regardless of the network type.

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 serverIF 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> [, <Duration maximale>])

<Result>: Boolean

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

<Socket name>: Character string (with quotes)

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

<Duration maximale>: Optional integer or optional Duration

Maximum timeout (in milliseconds).
This function is a locking 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 direct indication of duration (1 s or 10 ms for example).
New in version 23
the direct indication of duration (1 s or 10 ms for example).
the direct indication of duration (1 s or 10 ms for example).

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 : wd250com.dll