Xojo Conferences
XDCMay2019MiamiUSA

Platforms to show: All Mac Windows Linux Cross-Platform

WindowsBlueToothSocketMBS.Authenticate as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property Bluetooth MBS Bluetooth Plugin 18.1 No Yes No Yes, Windows only No
Function: Whether to autheticate connection.
Notes:
For disconnected sockets, the Authenticate options specifies whether authentication is required for a connect or accept operation to complete successfully. Setting this socket option actively initiates authentication during connection establishment, if the two Bluetooth devices were not previously authenticated. The user interface for passkey exchange, if necessary, is provided by the operating system outside the application context.

For outgoing connections that require authentication, the connect operation fails with WSAEACCES if authentication is not successful. In response, the application may prompt the user to authenticate the two Bluetooth devices before connection.
For incoming connections, the connection is rejected if authentication cannot be established and returns a WSAEHOSTDOWN error. For more information about authenticating Bluetooth devices, see BluetoothAuthenticateDevice function.

Lasterror is set.
(Read and Write property)

Feedback, Comments & Corrections

WindowsBlueToothSocketMBS.AvailableBytes as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property Bluetooth MBS Bluetooth Plugin 18.1 No Yes No Yes, Windows only No
Function: Queries available bytes in input buffer.
Notes:
Lasterror is set.
Returns -1 if unknown.
(Read only property)

Feedback, Comments & Corrections

WindowsBlueToothSocketMBS.BindAddress as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property Bluetooth MBS Bluetooth Plugin 18.1 No Yes No Yes, Windows only No
Function: The address the socket is bound to.
Notes: (Read only property)

Feedback, Comments & Corrections

WindowsBlueToothSocketMBS.BindPort as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property Bluetooth MBS Bluetooth Plugin 18.1 No Yes No Yes, Windows only No
Function: The port the socket is bound to.
Notes: (Read only property)

Feedback, Comments & Corrections

WindowsBlueToothSocketMBS.Encrypt as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property Bluetooth MBS Bluetooth Plugin 18.1 No Yes No Yes, Windows only No
Function: Whether to encrypt connection.
Notes:
On unconnected sockets, the Encrypt socket option enforces encryption to establish a connection. Encryption is only available for authenticated connections. For incoming connections, a connection for which encryption cannot be established is automatically rejected and returns WSAEHOSTDOWN as the error. For outgoing connections, the connect function fails with WSAEACCES if encryption cannot be established. In response, the application may prompt the user to authenticate the two Bluetooth devices before connection. For more information about authenticating Bluetooth devices, see BluetoothAuthenticateDevice.

Windows XP with SP2: For a socket that is connected and authenticated, SO_BTH_ENCRYPT starts encryption.
(Read and Write property)

Feedback, Comments & Corrections

WindowsBlueToothSocketMBS.Handle as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property Bluetooth MBS Bluetooth Plugin 18.1 No Yes No Yes, Windows only No
Function: The internal socket reference number.
Notes: (Read only property)

Feedback, Comments & Corrections

WindowsBlueToothSocketMBS.Lasterror as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property Bluetooth MBS Bluetooth Plugin 18.1 No Yes No Yes, Windows only No
Function: The last error code.
Notes: (Read only property)

Feedback, Comments & Corrections

WindowsBlueToothSocketMBS.LastErrorMessage as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property Bluetooth MBS Bluetooth Plugin 18.3 No Yes No Yes, Windows only No
Function: The last error message.
Notes: (Read only property)

Feedback, Comments & Corrections

WindowsBlueToothSocketMBS.Listening as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property Bluetooth MBS Bluetooth Plugin 18.1 No Yes No Yes, Windows only No
Function: Whether we are listening.
Notes:
Set to true on success by Bind method.
(Read only property)

Feedback, Comments & Corrections

WindowsBlueToothSocketMBS.LocalAddress as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property Bluetooth MBS Bluetooth Plugin 18.1 No Yes No Yes, Windows only No
Function: Queries local bluetooth address.
Notes:
Lasterror is set.
Value is empty if not known.
(Read only property)

Feedback, Comments & Corrections

WindowsBlueToothSocketMBS.LocalPort as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property Bluetooth MBS Bluetooth Plugin 18.1 No Yes No Yes, Windows only No
Function: Queries local port.
Notes:
Value is -1 if not set.
Lasterror is set.
(Read only property)

Feedback, Comments & Corrections

WindowsBlueToothSocketMBS.MTU as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property Bluetooth MBS Bluetooth Plugin 18.1 No Yes No Yes, Windows only No
Function: The MTU property.
Notes:
The MTU socket option is an advanced option used primarily for validation. The MTU option obtains or sets default RFCOMM MTU (maximum transmission unit) for connection negotiation to a value different than the RFCOMM protocol-default value.
Because MTU is affected by the underlying L2CAP MTU, and protocol and application minimums and maximums, the default value for SO_BTH_MTU is only a starting point for negotiation with the remote peer, and the final negotiated MTU is likely to vary from the default. Setting the MTU value may negatively affect throughput, and as such, any modification should be performed with knowledge of the underlying Bluetooth protocol.

The MTU socket option can be performed on connected sockets, but has no effect if the negotiation has already completed. Setting it on the listening (server) socket has no effect.

The amount of data that an application can send or receive in a single socket call is not affected by the MTU; MTU only affects how the underlying Windows Sockets service provider segments packets for transport. Both the proposed MTU and the MTU ultimately negotiated must be between RFCOMM_MIN_MTU (&h17) and RFCOMM_MAX_MTU (&3F3), as defined in the Ws2bth.h header file.
(Read and Write property)

Feedback, Comments & Corrections

WindowsBlueToothSocketMBS.MTUMax as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property Bluetooth MBS Bluetooth Plugin 18.1 No Yes No Yes, Windows only No
Function: The MTU max property.
Notes:
The MTUMax socket option is an advanced option used primarily for validation. The MTUMax socket option sets the maximum RFCOMM MTU (maximum transmission unit) for connection negotiation. Connections with an RFCOMM MTU equal to or greater than this value fail during the connect/accept process. While setting this socket option is allowed for a connected socket, it has no effect if the negotiation has completed. Setting this socket option on a listening socket propagates the value for all incoming connections. The MAX MTU value must be between RFCOMM_MIN_MTU (&h17) and RFCOMM_MAX_MTU (&3F3), as defined in the Ws2bth.h header file.
(Read and Write property)

Feedback, Comments & Corrections

WindowsBlueToothSocketMBS.MTUMin as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property Bluetooth MBS Bluetooth Plugin 18.1 No Yes No Yes, Windows only No
Function: The MTU min property.
Notes:
The MTUMin socket option is an advanced option used primarily for validation. The MTUMin socket option sets the minimum RFCOMM MTU (maximum transmission unit) for connection negotiation. Connections with an RFCOMM MTU smaller than this value fail during the connect/accept process. While setting this socket option is allowed for a connected socket, it has no effect if the negotiation has completed. Setting this socket option on a listening socket propagates the value for all incoming connections.
Only a listening socket can revise the MTU downward, therefore if the value proposed by the connecting socket is less than the value set for MTUMin on the listening socket, the connection is refused. The minimum MTU must be between RFCOMM_MIN_MTU (&h17) and RFCOMM_MAX_MTU (&3F3), as defined in the Ws2bth.h header file.
(Read and Write property)

Feedback, Comments & Corrections

WindowsBlueToothSocketMBS.RemoteAddress as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property Bluetooth MBS Bluetooth Plugin 18.1 No Yes No Yes, Windows only No
Function: Queries remote address.
Notes:
Lasterror is set.
Value is empty if not known.
(Read only property)

Feedback, Comments & Corrections

WindowsBlueToothSocketMBS.RemotePort as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property Bluetooth MBS Bluetooth Plugin 18.1 No Yes No Yes, Windows only No
Function: Queries remote port.
Notes:
Lasterror is set.
Value is -1 if not set.
(Read only property)

Feedback, Comments & Corrections

WindowsBlueToothSocketMBS.SDPRecordID as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property Bluetooth MBS Bluetooth Plugin 18.1 No Yes No Yes, Windows only No
Function: The SPF record ID for published service.
Notes: (Read only property)

Feedback, Comments & Corrections

The items on this page are in the following plugins: MBS Bluetooth Plugin.




Links
MBS FileMaker Plugins