C++ License Status Codes
The Keyzy::LicenseStatus enum is returned by activation, validation, deactivation, and deposit methods in the KEYZY C++ Client Library. Use these values to determine the result of any operation and display appropriate messages to your users.
#include "KeyzyTypes.h"
Keyzy::LicenseStatus status = pActivator->activateSemiOnline(serialNumber);
Success
| Status | Description |
|---|
VALID | The operation was successful. The license is valid. |
ACTIVATION_DELETED | The license was successfully deactivated on the KEYZY server. |
License Errors
| Status | Description |
|---|
INVALID | The license is invalid. General error for unspecified cases. |
EXPIRED | A local (client-only) trial license has expired. Returned by validateTrialLicense(). |
SERIAL_INVALID | The serial number is invalid or not registered on the KEYZY server. |
ACTIVATION_DEACTIVATED | This activation has been deactivated (e.g. by the dashboard or API). |
REACHED_MAX_NUMBER_OF_HOST | The serial has reached its maximum number of allowed activations. |
Subscription and Trial Errors
| Status | Description |
|---|
SUBSCRIPTION_LICENSE_EXPIRED | The subscription period has ended. |
SUBSCRIPTION_LICENSE_NOT_STARTED | The subscription has a future start date and is not yet active. |
TRIAL_LICENSE_EXPIRED | The server-side trial period has ended. |
TRIAL_LICENSE_NOT_STARTED | The server-side trial has a future start date and is not yet active. |
ANOTHER_TRIAL_LICENSE_ALREADY_ACTIVATED | Another trial license has already been activated on this device. |
Product and SKU Errors
| Status | Description |
|---|
PRODUCT_NOT_EXIST | The product code does not exist on the KEYZY server. |
PRODUCT_NOT_EXIST_FOR_USER | The product code does not exist for your account. |
PRODUCT_NOT_ACTIVE | The product is not active in the dashboard. |
PRODUCT_NOT_EXIST_FOR_SKU | The product exists but does not include the SKU connected to the license. |
SKU_NOT_EXIST | The SKU does not exist on the KEYZY server. |
SKU_NOT_ACTIVE | The SKU is deactivated in the dashboard. |
Authentication and Connection Errors
| Status | Description |
|---|
NOT_AUTHORIZED | The App ID and API Key pair is incorrect. |
CONNECTION_ERROR | Network or firewall error. The internet connection is unavailable or blocked. |
TOO_MANY_REQUESTS | Too many requests sent in a short time. Wait and retry. |
NO_ACTIVE_SUBSCRIPTION | The KEYZY account holder has a subscription issue with the KEYZY service. |
Client-Side Errors
| Status | Description |
|---|
CANNOT_KEEP_SERIAL | The library could not store the serial number on the device. |
CANNOT_KEEP_LICENSE_FILE | The library could not store the license file on the device. The file path may be incorrect or write permissions may be missing. |
CLIENT_SERIAL_DOES_NOT_EXIST | No serial number is stored on the device. The user needs to activate first. |
Upgrade Errors
| Status | Description |
|---|
CURRENT_LICENSE_DOES_NOT_EXIST | The source serial number for the upgrade does not exist on the KEYZY server. |
UPGRADE_LICENSE_DOES_NOT_EXIST | The target serial number for the upgrade does not exist on the KEYZY server. |
UPGRADE_LICENSE_DOES_NOT_MATCH | The upgrade license does not match the current license for this upgrade path. |
Deposit and Validation Errors
| Status | Description |
|---|
SKU_NUMBER_VALIDATION | The SKU number parameter could not be validated. |
PRODUCT_CODE_VALIDATION | The product code parameter could not be validated. |
NAME_VALIDATION | The name parameter could not be validated. |
EMAIL_VALIDATION | The email parameter could not be validated. |
NAME_OR_EMAIL_VALIDATION | Either the name or email field must be provided. |
NO_FREE_LICENSES | No free licenses are available for this SKU. Generate new licenses in the dashboard. |
LICENSE_NOT_EXIST_NOT_ASSIGNED_DEALER_ALREADY_DEPOSITED | The license does not exist, is not assigned to a dealer, or has already been deposited. |