Create a socket bound to an incoming connection.
UDPBind ( IPAddr, port )
| IPAddr | Internet Protocol dotted address(IpV4) as "192.162.1.1". |
| port | port on which the created socket will be bound. |
| Success: | an array : $aArray[1] contains the real socket, $aArray[2] contains the specified IP address and $aArray[3] contains the port. We need this information in subsequent calls to UDPRecv(), where we pass this socket structure/array. |
| Failure: | Sets the @error flag to non-zero. |
| @error: | 1 - IPAddr is incorrect. 2 - port is incorrect. Windows API WSAGetLastError return value (see MSDN). |
UDPCloseSocket, UDPOpen, UDPRecv, UDPSend
#include <MsgBoxConstants.au3>
Example()
Func Example()
UDPStartup() ; Start the UDP service.
; Register OnAutoItExit to be called when the script is closed.
OnAutoItExitRegister("OnAutoItExit")
; Assign Local variables the loopback IP Address and the Port.
Local $sIPAddress = "127.0.0.1" ; This IP Address only works for testing on your own computer.
Local $iPort = 65532 ; Port used for the connection.
; Assign a Local variable the socket and bind to the IP Address and Port specified.
Local $aSocket = UDPBind($sIPAddress, $iPort)
; If an error occurred display the error code and return False.
If @error Then
; Someone is probably already binded on this IP Address and Port (script already running?).
Local $iError = @error
MsgBox(($MB_ICONERROR + $MB_SYSTEMMODAL), "", "Could not bind, Error code: " & $iError)
Return False
Else
MsgBox($MB_SYSTEMMODAL, "", "Bind successful.")
EndIf
; Close the Listening socket to allow afterward binds.
; While not closed, any other program can NOT bind to the same IP Address and Port.
UDPCloseSocket($aSocket)
EndFunc ;==>Example
Func OnAutoItExit()
UDPShutdown() ; Close the UDP service.
EndFunc ;==>OnAutoItExit