SocketWrite (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Communication with robots or with non-WINDEV applications
Transmission between two computers that use character strings in different formats (UNICODE and ANSI)
Required permissions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

SocketWrite (Function)

In french: SocketEcrit

Writes a message intended to another socket. This function can be used on a client computer or on a server.

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

Versions 15 and later

This function is now available for Android applications.

New in version 15

This function is now available for Android applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

This function is now available for Windows Phone applications.

New in version 17

This function is now available for iPhone/iPad applications.

This function is now available for Windows Phone applications.

This function is now available for iPhone/iPad applications.

This function is now available for Windows Phone applications.

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 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

IF SocketWrite("server", "hello world") = True THEN
Message("Message sent")
END

IF SocketWrite("Server", "hello world", "www.info.fr", 2005) = True THEN
Message("Message sent")
END

Syntax

Writing into a socket Hide the details

<Result> = SocketWrite(<Socket name> , <Message>)

<Result>: Boolean

True if the function was successful,
False otherwise. If an error occurs, you can get the details of the error with ErrorInfo.

<Socket name>: Character string

Name of the socket that received the message.
In a WINDEV application, this name was defined on the server:
by SocketCreate, SocketCreateSSL or SocketCreateInfrared (for a simplified server)
by SocketAccept (for a standard server).
by SocketConnect (WEBDEV site).
In a WINDEV application, on the client, this name was defined by SocketConnect, SocketConnectSSL or SocketConnectInfrared.

<Message>: String or buffer

Message to transmit. The message format can be defined with SocketChangeTransmissionMode.

Writing into a UDP socket Hide the details

<Result> = SocketWrite(<Socket name> , <Message> , <Destination address> , <Port number>)

<Result>: Boolean

True if the function was successful,
False otherwise. If an error occurs, you can get the details of the error with ErrorInfo.

<Socket name>: Character string

Name of the socket that received the message. This name was defined by SocketCreateUDP.

<Message>: Character string

Message to transmit. The message format can be defined by SocketChangeTransmissionMode.

<Destination address>: Character string

Address of the destination computer. This address can be given in the following format:
IP address in XXX.XXX.XXX.XXX format (125.5.110.100 for example).
URL containing the server name (www.windev.com for example). This syntax is recommended.
IP address returned by NetIPAddress.
UDP socket: The UDP protocol is a "connectionless" protocol. The destination must be specified for each send operation. This address can be a sub-network mask, allowing you to send the message to all the computers connected with this sub-network mask.

<Port number>: Integer

Port number of the target socket.
If you are using a socket associated with a preset protocol, use the port number associated with the protocol.
If this parameter is not specified, the number taken into account corresponds to the last destination port number used for writing for this socket.

Remarks

Communication with robots or with non-WINDEV applications

To simplify the exchanges of data by socket, a transmission mode is initialized by default.

For a communication with an external module (non-WINDEV application, robot, ...), this transmission mode can prevent the communications from operating properly.

SocketChangeTransmissionMode is used to change this transmission mode: the SocketNoEndTag constant allows you not to modify the frames read and written.

Transmission between two computers that use character strings in different formats (UNICODE and ANSI)

Some conversions may be required when messages are transmitted between two computers that use character strings in different formats (Windows (ANSI) and Windows Mobile (UNICODE) for example). These conversions can be performed by AnsiToUnicode and UnicodeToAnsi.

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