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

The LMX_Admin_VerifyCredentials function verifies credentials for the specified server.

Prototype

LMX_STATUS LMX_Admin_VerifyCredentials
(
   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 verify credentials. The maximum length of the hostname can be up to LMX_MAX_LONG_STRING_LENGTH.

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

szPassword
[in] Password to verify. 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. If the authorization fails, this function returns LMX_AUTH_ERROR.

If there are too many failed attempts, this function returns the status code LMX_AUTH_TOO_MANY.

Other error codes returned on failure are described in Return codes.