edmiTerminateClient
- Former user (Deleted)
EdmiError edmiTerminateClient(SdaiString password,
SdaiClientId clientId,
SdaiInteger options);
Disconnects a client from the EDM Server. For various reasons, such as system maintenance, it may be necessary to disconnect all clients from an EDM Server. When you try to disconnect a client from the EDM Server, you must give the superuser password. The client may be terminated in two ways. Either by telling the client to disconnect the next time it sends a request to the EDM Server, or by simply killing the connection and leave it to the client to sort out any problems. To prevent the clients to reconnect, use edmiSetUnavailable.
Arguments
| Type | Name | Comment |
| SdaiString | Password | The password of the superuser. |
| SdaiClientId | ClientId | The client Id of the connection to terminate |
| SdaiInteger | Options | One of the options listed below. |
Return Value
Options
| Option | Comment |
|---|---|
KILL_CLIENT | The client will be inmediately disconnected. Ongoing tasks will be aborted and rolled back. The client will receive the error message edmiE_STOPPED |
FORCE_TO_TERMINATE | Tell the client to disconnect the next time he sends a request to the EDM Server. Any ongoing tasks will be allowed to complete any succeeding requests will result in the error message edmiE_FORCE_DISCONNECT |
Example
EdmiError rstat;
SdaiClientId clientId;
SdaiString hostName;
SdaiString s;
SdaiUnsignedInt key;
...
if (rstat = edmiGetClientId("Johnny", &clientId, &hostName)) {
goto error;
}
edmiChangeMyUser("superuser", "", "gZw76Ab", &s, &key);
edmiSetUnavailable("Sorry Johnny!! You're out!");
if (rstat = edmiTerminateClient("gZw76Ab", clientId, KILL_CLIENT)) {
printf("\nError %d in edmiTerminateClient: %s", rstat
edmiGetErrorText(rstat));
goto error;
}
printf("\nKilled johnny@%s", &hostname);
. . .
See also
Filter by label
There are no items with the selected labels at this time.