SocketWaitForConnection (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

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.

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 iPhone/iPad applications.

New in version 19

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
ThreadExécute("Thread1", threadNormal, WaitProcedure)
END

INTERNAL PROCÉDURE WaitProcedure()
IF SocketWaitForConnection("Server") THEN
Channel is string
// If the connection is accepted,
// this connection is managed in a specific thread
Channel = SocketAccept("Server")
ThreadExécute(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 (with quotes)

Name of the server socket that waits for the connection.

<Maximum timeout>: 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
direct indication of the Duration (e.g. 1 s or 10 ms).
New in version 23
direct indication of the Duration (e.g. 1 s or 10 ms).
direct indication of the Duration (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: wd260com.dll