/// <summary>
/// Sends the request to the LexFloatServer to free the license.
///
/// Call this function before you exit your application to prevent zombie licenses.
/// </summary>
public static void DropFloatingLicense()
{
int status = IntPtr.Size == 4 ? LexFloatClientNative.DropFloatingLicense_x86() : LexFloatClientNative.DropFloatingLicense();
if (LexFloatStatusCodes.LF_OK != status)
{
throw new LexFloatClientException(status);
}
}
/// <summary>
/// Gets the license expiry date timestamp of the LexFloatServer license.
/// </summary>
/// <returns>Returns the timestamp.</returns>
public static uint GetHostLicenseExpiryDate()
{
uint expiryDate = 0;
int status = IntPtr.Size == 4 ? LexFloatClientNative.GetHostLicenseExpiryDate_x86(ref expiryDate) : LexFloatClientNative.GetHostLicenseExpiryDate(ref expiryDate);
switch (status)
{
case LexFloatStatusCodes.LF_OK:
return(expiryDate);
default:
throw new LexFloatClientException(status);
}
}
/// <summary>
/// Checks whether any license has been leased or not.
/// </summary>
/// <returns>true or false</returns>
public static bool HasFloatingLicense()
{
int status = IntPtr.Size == 4 ? LexFloatClientNative.HasFloatingLicense_x86() : LexFloatClientNative.HasFloatingLicense();
switch (status)
{
case LexFloatStatusCodes.LF_OK:
return(true);
case LexFloatStatusCodes.LF_E_NO_LICENSE:
return(false);
default:
throw new LexFloatClientException(status);
}
}
/// <summary>
/// Sets the network address of the LexFloatServer.
///
/// The url format should be: http://[ip or hostname]:[port]
/// </summary>
/// <param name="hostUrl">url string having the correct format</param>
public static void SetHostUrl(string hostUrl)
{
int status;
if (LexFloatClientNative.IsWindows())
{
status = IntPtr.Size == 4 ? LexFloatClientNative.SetHostUrl_x86(hostUrl) : LexFloatClientNative.SetHostUrl(hostUrl);
}
else
{
status = LexFloatClientNative.SetHostUrlA(hostUrl);
}
if (LexFloatStatusCodes.LF_OK != status)
{
throw new LexFloatClientException(status);
}
}
/// <summary>
/// Resets the meter attribute uses of the floating client.
/// </summary>
/// <param name="name">name of the meter attribute</param>
public static void ResetFloatingClientMeterAttributeUses(string name)
{
int status;
if (LexFloatClientNative.IsWindows())
{
status = IntPtr.Size == 4 ? LexFloatClientNative.ResetFloatingClientMeterAttributeUses_x86(name) : LexFloatClientNative.ResetFloatingClientMeterAttributeUses(name);
}
else
{
status = LexFloatClientNative.ResetFloatingClientMeterAttributeUsesA(name);
}
if (LexFloatStatusCodes.LF_OK != status)
{
throw new LexFloatClientException(status);
}
}
/// <summary>
/// Sets the product id of your application.
/// </summary>
/// <param name="productId">the unique product id of your application as mentioned on the product page in the dashboard</param>
public static void SetHostProductId(string productId)
{
int status;
if (LexFloatClientNative.IsWindows())
{
status = IntPtr.Size == 4 ? LexFloatClientNative.SetHostProductId_x86(productId) : LexFloatClientNative.SetHostProductId(productId);
}
else
{
status = LexFloatClientNative.SetHostProductIdA(productId);
}
if (LexFloatStatusCodes.LF_OK != status)
{
throw new LexFloatClientException(status);
}
}
/// <summary>
/// Sets the floating client metadata.
///
/// The metadata appears along with the license details of the license in
/// LexFloatServer dashboard.
/// </summary>
/// <param name="key">string of maximum length 256 characters with utf-8 encoding</param>
/// <param name="value">string of maximum length 256 characters with utf-8 encoding</param>
public static void SetFloatingClientMetadata(string key, string value)
{
int status;
if (LexFloatClientNative.IsWindows())
{
status = IntPtr.Size == 4 ? LexFloatClientNative.SetFloatingClientMetadata_x86(key, value) : LexFloatClientNative.SetFloatingClientMetadata(key, value);
}
else
{
status = LexFloatClientNative.SetFloatingClientMetadataA(key, value);
}
if (LexFloatStatusCodes.LF_OK != status)
{
throw new LexFloatClientException(status);
}
}
/// <summary>
/// Sets the renew license callback function.
///
/// Whenever the license lease is about to expire, a renew request is sent to
/// the server. When the request completes, the license callback function
/// gets invoked with one of the following status codes:
///
/// LF_OK, LF_E_INET, LF_E_LICENSE_EXPIRED_INET, LF_E_LICENSE_NOT_FOUND, LF_E_CLIENT, LF_E_IP,
/// LF_E_SERVER, LF_E_TIME, LF_E_SERVER_LICENSE_NOT_ACTIVATED,LF_E_SERVER_TIME_MODIFIED,
/// LF_E_SERVER_LICENSE_SUSPENDED, LF_E_SERVER_LICENSE_EXPIRED, LF_E_SERVER_LICENSE_GRACE_PERIOD_OVER
/// </summary>
/// <param name="callback"></param>
public static void SetFloatingLicenseCallback(CallbackType callback)
{
var wrappedCallback = callback;
#if NETFRAMEWORK
var syncTarget = callback.Target as System.Windows.Forms.Control;
if (syncTarget != null)
{
wrappedCallback = (v) => syncTarget.Invoke(callback, new object[] { v });
}
#endif
callbackList.Add(wrappedCallback);
int status = IntPtr.Size == 4 ? LexFloatClientNative.SetFloatingLicenseCallback_x86(wrappedCallback) : LexFloatClientNative.SetFloatingLicenseCallback(wrappedCallback);
if (LexFloatStatusCodes.LF_OK != status)
{
throw new LexFloatClientException(status);
}
}
/// <summary>
/// Gets the meter attribute uses consumed by the floating client.
/// </summary>
/// <param name="name"></param>
/// <returns>Returns the value of meter attribute uses by the activation.</returns>
public static uint GetFloatingClientMeterAttributeUses(string name)
{
uint uses = 0;
int status;
if (LexFloatClientNative.IsWindows())
{
status = IntPtr.Size == 4 ? LexFloatClientNative.GetFloatingClientMeterAttributeUses_x86(name, ref uses) : LexFloatClientNative.GetFloatingClientMeterAttributeUses(name, ref uses);
}
else
{
status = LexFloatClientNative.GetFloatingClientMeterAttributeUsesA(name, ref uses);
}
if (LexFloatStatusCodes.LF_OK == status)
{
return(uses);
}
throw new LexFloatClientException(status);
}
/// <summary>
/// Gets the license meter attribute allowed uses, total uses and gross uses associated
/// with the LexFloatServer license.
/// </summary>
/// <param name="name">name of the meter attribute</param>
/// <returns>Returns the values of meter attribute allowed and total uses.</returns>
public static LicenseMeterAttribute GetHostLicenseMeterAttribute(string name)
{
uint allowedUses = 0, totalUses = 0, grossUses = 0;
int status;
if (LexFloatClientNative.IsWindows())
{
status = IntPtr.Size == 4 ? LexFloatClientNative.GetHostLicenseMeterAttribute_x86(name, ref allowedUses, ref totalUses, ref grossUses) : LexFloatClientNative.GetHostLicenseMeterAttribute(name, ref allowedUses, ref totalUses, ref grossUses);
}
else
{
status = LexFloatClientNative.GetHostLicenseMeterAttributeA(name, ref allowedUses, ref totalUses, ref grossUses);
}
if (LexFloatStatusCodes.LF_OK == status)
{
return(new LicenseMeterAttribute(name, allowedUses, totalUses, grossUses));
}
throw new LexFloatClientException(status);
}
/// <summary>
/// Get the value of the license metadata field associated with the
/// LexFloatServer license key.
/// </summary>
/// <param name="key">metadata key to retrieve the value</param>
/// <returns>Returns the value of metadata for the key.</returns>
public static string GetHostLicenseMetadata(string key)
{
var builder = new StringBuilder(256);
int status;
if (LexFloatClientNative.IsWindows())
{
status = IntPtr.Size == 4 ? LexFloatClientNative.GetHostLicenseMetadata_x86(key, builder, builder.Capacity) : LexFloatClientNative.GetHostLicenseMetadata(key, builder, builder.Capacity);
}
else
{
status = LexFloatClientNative.GetHostLicenseMetadataA(key, builder, builder.Capacity);
}
if (LexFloatStatusCodes.LF_OK == status)
{
return(builder.ToString());
}
throw new LexFloatClientException(status);
}