Multiuser Lingo Dictionary > Multiuser Lingo Dictionary > getNetErrorString() |  |

getNetErrorString()

Syntax

    gMultiuserInstance.getNetErrorString(errorCodeNumber)

Description

Multiuser Server Lingo command; returns a string explaining the error code that is provided in place of `errorCodeNumber`. If the error code is invalid, this command returns a string representing an unknown error. Error codes are negative integers; 0 indicates that no error occurred.

Possible error codes and their strings are as follows:

Error code | Translated error string
--- | ---
0 | No error
-2147216223 | Unknown error
-2147216222 | Invalid movie ID
-2147216221 | Invalid user ID
-2147216220 | Invalid password
-2147216219 | Incoming data has been lost
-2147216218 | Invalid server name
-2147216217 | Server or movie is full; no connections are available
-2147216216 | Bad parameter
-2147216215 | No socket manager present
-2147216214 | No current connection
-2147216213 | No waiting message
-2147216212 | Bad connection ID
-2147216211 | Wrong number of parameters
-2147216210 | Unknown internal error
-2147216209 | Connection was refused
-2147216208 | Message is too large or message buffer is full
-2147216207 | Invalid message format
-2147216206 | Invalid message length
-2147216205 | Message is missing
-2147216204 | Server initialization failed
-2147216203 | Server send failed
-2147216202 | Server close failed
-2147216201 | Connection is a duplicate
-2147216200 | Invalid number of message recipients
-2147216199 | Invalid message recipient
-2147216198 | Invalid message
-2147216197 | Server internal error
-2147216196 | Error joining group
-2147216195 | Error leaving group
-2147216194 | Invalid group name
-2147216193 | Invalid server command
-2147216192 | Not permitted with this user level
-2147216191 | Error with database
-2147216190 | Invalid server initialization file
-2147216189 | Error writing database
-2147216188 | Error reading database
-2147216187 | User ID not found in database
-2147216186 | Error adding new user
-2147216185 | Database is locked
-2147216184 | Data record is not unique
-2147216183 | No current record
-2147216182 | Record does not exist
-2147216181 | Moved past beginning or end of database
-2147216180 | Data not found
-2147216179 | No current tag selected
-2147216178 | No current database
-2147216177 | Can't find configuration file
-2147216176 | Current database record is not locked
-2147216175 | Operation not allowed at current security level
-2147216174 | Requested data or object was not found
-2147216173 | Message content contains error information
-2147216172 | Data concurrency error

Example

These statements attempt to connect to a multiuser server and display the error string in an alert if the attempt fails:

    errCode = gMultiuserInstance.connectToNetServer([#logonInfo: \ [#userID: "Howard", #password: "mySecret", #movieID: \
    "chatMovie"], #remoteAddress: "chatServer.myCompany.com", \ #remoteTCPPort: 1626, #localAddress: 123.23.45.678])
    if errCode <> 0 then
    	alert "Connection attempt failed!" & RETURN & \
    	gMultiuserInstance.getNetErrorString(errCode)
    end if