Simrad ER60, Operator'S Manual

Page: 152 / 182

Simrad ER60 Operator manual
144
850-164692 / Rev.B
Connecting to server
Before commands can be sent to the server application, the
client application must identify itself to the server application by
sending a connect command,
ConnectRequest , to the server.
This connect command must contain user account and password
information.
ConnectRequest
The contents of the connect message is shown below.
struct ConnectRequest
{
char Header[4];
// ”CON\0”
char ClientInfo[1024];
// e.g. ”Name:Simrad;Password:\0”
};
Response
The server application will respond with a Response message
containing at least the client id if the connect command
succeeded, or an error if the connect command failed. The
contents of the various parts of a response message for a
successful connect command is shown below.
struct Response
{
char Header[4];
// ”RES\0”
char Request[4];
// ”CON/0”
char MsgControl[22];
// ”\0”
char MsgResponse[1400];
// Response text containing result of
// connection request
}
MsgResponse
The contents of the MsgResponse field consist of ResultCode
and Parameters .
ResultCode - Result of the operation. The following values can
be present.
•
S_OK - operation was successful
•
E_ACCESSDENIED - operation failed due to unknown
account or wrong password.
•
E_FAIL - operation failed due to an unspecified error.
Parameters - Comma separated list of various name:value pairs
that may be present, only provided if the ConnectRequest is
successful.