NoteDans ce contexte, l’unité de traitement du système EK80 est considérée comme le « serveur ». Le programme du système EK80 est « l’application serveur ». Le programme que vous créez vous-même pour une exécution sur un ordinateur local est appelé « application client ».
ConnectRequest
Le contenu du message ConnectRequest est présenté ci-dessous.
struct ConnectRequest |
|
{ |
|
|
char Header[4]; |
|
|
char ClientInfo[1024]; |
|
}; |
|
• |
ClientInfo Cette chaîne de texte doit inclure le nom et le nom d'utilisateur au format suivant : Name:Simrad;Password:\0 |
Response
L’application serveur du système EK80 répondra avec un message de Response. Si la commande ConnectRequest réussi, elle contiendra au moins l’identification du client. Si la commande ConnectRequest échoue, elle contiendra un message d'erreur.
struct Response |
|
{ |
|
|
char Header[4]; |
|
|
char Request[4]; |
|
|
char MsgControl[22]; |
|
|
char MsgResponse[1400]; |
|
}; |
Le champ MsgResponse est constitué d'un ResultCode et de Parameters.
|
1 |
Le ResultCode contient le résultat de la commande ConnectRequest. Les valeurs suivantes sont définies.
|
• |
S_OK: L'opération a réussi. |
|
• |
E_ACCESSDENIED: L'opération a échoué en raison d'un compte inconnu ou d'un mot de passe incorrect. |
|
• |
E_FAIL: L'opération a échoué en raison d'une erreur non spécifiée. |
|
|
2 |
Les Parameters sont une liste séparée par des virgules de plusieurs paires « nom: valeur » qui peuvent être présentes. Ces paramètres ne
sont fournis que si ConnectRequest a réussi. Les valeurs suivantes sont définies.
|
• |
ClientID: Ceci est l'identification du client actuel. Les informations sont utilisées dans toutes les communications ultérieures avec l'application serveur. |
|
• |
AccessLevel: C'est le niveau d'accès général pour le client actuel. |
|
Une connexion réussie fournira par exemple un message MsgResponse.
ResultCode:S_OK,
Parameters:{ClientID:1,AccessLevel:1}\0
Si la commande ConnectRequest échoue, le ResponseField contiendra le champ ResultInfo. Ce champ contiendra du texte décrivant l'échec.