Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

Socket.NewTCPSocket

Creates a new TCP Socket.

Component Version macOS Windows Linux Server iOS SDK
Socket 3.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "Socket.NewTCPSocket" { ; PreferIPv6 } )   More

Parameters

Parameter Description Example Flags
PreferIPv6 Available in MBS FileMaker Plugin 8.4 or newer.
Pass 1 to get IPv6 or if not available IPv4.
Pass 0 to get IPv4 or if not available IPv6.
Default is 1 for preferring IPv6.
1 Optional

Result

Returns a new socket ID or error message.

Description

Creates a new TCP Socket.
Socket reference numbers are starting at 29000 and counting up for each new socket.

If you call Socket.Connect, you don't need to use this method first as the connect function creates its own socket.
For MBS Plugin 8.3 or newer this may be IPv6 or IPv4 socket.

Examples

Create TCP Socket listening on a port:

Set Variable [$$sock; Value:MBS("Socket.NewTCPSocket")]
If [MBS("IsError")]
    Show Custom Dialog ["Failed to create Socket"; $$sock]
    Exit Script []
End If
Set Variable [$r; Value:MBS("Socket.SetNewConnectionHandler"; $$sock; Get(FileName); "NewConnection")]
Set Variable [$r; Value:MBS("Socket.SetErrorHandler"; $$sock; Get(FileName); "SocketError")]
Set Variable [$r; Value:MBS("Socket.Listen"; $$sock; TCP Receiver::ListenPort)]
If [MBS("IsError")]
    Show Custom Dialog ["Failed to create Socket"; $$sock]
    Exit Script []
End If

See also

Release notes

  • Version 10.1
  • Version 8.4

Example Databases

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 19th September 2018


Socket.LocalPort - Socket.NewUDPSocket