The information on this page refers to LM-X v5.4.1 or newer, which introduced brute force password protection.

The LMX_Admin_ShutdownServer function shuts down the specified server.

Prototype

LMX_STATUS LMX_Admin_ShutdownServer
(
   LMX_HANDLE LmxHandle,
   const char *szHostname,
   int nPort,
   const char *szPassword
);

Parameters

LmxHandle
[in/out] LM-X handle.

szHostname
[in] Hostname of the license server to be shut down. The maximum length of the hostname can be up to LMX_MAX_LONG_STRING_LENGTH.

nPort
[in] Port of the license server to be shut down. Port must be within the range of 1 - 65535.

szPassword
[in] Password of the license server to be shut down. The maximum length of the password can be up to LMX_MAX_LONG_STRING_LENGTH. Note that LM-X uses brute force password protection to prevent brute-force attacks.

Return values

On success, this function returns the status code LMX_SUCCESS.

On failure, this function returns an error code in the format described in SOAP API return codes.

Remarks

This function sends a shut down command to the license server specified in szHostname. If the password specified in szPassword matches the password in the license server's configuration file, the server will be shut down, and LMX_SUCCESS will be returned. If the passwords do not match, the server will not be shut down, and LMX_LMX_NETWORK_DENY will be returned.

(Note: License server shut down can also be done using the LM-X web-based UI, as described in Restarting or shutting down the server.)