RT_LICENSE_INFO
RT_LICENSE_INFO is a structure that specifies data for the function RtGetLicenses and RtkGetLicenses.
Syntax
typedef struct _RT_LICENSE_INFO { int size; int structureVersion; TCHAR featureName [RT_MAX_FEATURE_NAME_LENGTH]; DWORD majorVersion; RT_FEATURE_LICENSE_STATUS status; int isFeatureInstalled; RT_LICENSE_EXPIRATION_DATE expirationDate; RT_LICENSE_ISSUE_DATE issueDate; TCHAR dongleSerialNumber[DONGLE_ID_MAX_LENGTH]; RT_LICENSE_OPTIONS options; } RT_LICENSE_INFO, *PRT_LICENSE_INFO;
Fields
size
The size of the structure.
structureVersion
The version of the structure. This should always equal 1. Note that if your application sees an unexpected value in this field (i.e., not 1), the application cannot trust the data in any other field nor can it trust that the structure size is the same as when the application was compiled.
featureName
The name of the licensed feature.
Licensed Feature | Description |
---|---|
RTX64 | RTX64 Subsystem |
TCP64 |
RT-TCP/IP Stack |
BLD64 | Rebuild support |
SDK64 | Software Development Kit |
majorVersion
The major version of the licensed feature.
Licensed Feature | majorVersion Value |
---|---|
RTX64 3.0 | 3 |
RTX64 2014 (includes Service Packs) | 2 |
RTX64 2013 (includes Service Packs) |
1 |
RT_FEATURE_LICENSE_STATUS status
The license status. Possible status return codes are listed in the table below:
Status Code | Description |
---|---|
RT_FEATURE_STATUS_NOT_FOUND = 0 |
License entry not found |
RT_FEATURE_STATUS_FORMAT_ERROR |
The license entry is found but is in an invalid format |
RT_FEATURE_STATUS_VALID |
The license entry is found and is valid |
RT_FEATURE_STATUS_INVALID |
The license entry is found but is invalid |
RT_FEATURE_STATUS_EVAL |
The license entry found is a valid Evaluation license |
RT_FEATURE_STATUS_EVAL_EXPIRED | The license entry found is an expired Evaluation license |
RT_FEATURE_STATUS_EVAL_INVALID_HOST_ID | The license entry found is an invalid Evaluation dongle-based license, because the license is locked to hardware that is not present |
RT_FEATURE_STATUS_INVALID_HOST_ID | The license entry found is an invalid dongle-based license, because the license is locked to hardware that is not present |
isFeatureInstalled
Specifies whether the feature is installed. 0 means the feature is not installed. Non-0 means the feature is installed.
expirationDate
The expiration date of the license.
issueDate
The issue date of the license.
dongleSerialNumber
The serial number of the dongle the license is node-locked against. An empty string indicates the feature is licensed to the system hard disk, not to a dongle.
options
License-specific options.
Requirements
Minimum Supported Version | RTX64 2014 with Service Pack 2 |
Header | Licensing.h |