RtGetLicenseStatus
RtGetLicenseStatus returns whether the specified version of a product code has a valid license.
Syntax
BOOL RtGetLicenseStatus(
[in] const LPTSTR* pProductCode,
[in] DWORD MajorVersion
);
Parameters
[in] pProductCode
The product code. The table below lists the MaxRT wRTOS product codes:
| Product code | Name | Description |
|---|---|---|
|
WRTOS64 |
MaxRT wRTOS Runtime |
Allows you to use the wRTOS Subsystem, Network Link Layer (NL2), Network Relay, and Virtual Network. |
|
WNET64 |
MaxRT wRTOS Network |
Allows you to use the TCP/IP Stack. |
|
WVIS64 |
MaxRT wRTOS Vision |
Allows you to use GigE and GeniCam features with the TCP/IP Stack. Note: You must also have a WNET64 license to use Vision. |
|
WFBS64 |
MaxRT wRTOS Fieldbus |
Allows you to use available Fieldbuses (EtherCAT, other). |
|
WEMM64 |
MaxRT wRTOS E-CAT Multiple MainDevices |
Allows you to run multiple EtherCAT MainDevices. Note: This license also requires the WFB64 license. |
|
WEHST64 |
MaxRT wRTOS E-CAT High Speed Timer |
Allows the EtherCAT MainDevice to use a high-speed timer. Note: This license also requires the WFB64 license. |
|
WEHC64 |
MaxRT wRTOS E-CAT Hot Connect |
Allows the EtherCAT MainDevice to support Hot Connect. Note: This license also requires the WFB64 license. |
|
WECR64 |
MaxRT wRTOS E-CAT Cable Redundancy |
Allows the EtherCAT MainDevice to support Cable Redundancy. Note: This license also requires the WFB64 license. |
[in] MajorVersion
The major version of the specified product code to validate. For example, for version 1.3, 1 is the major version number.
Use macro USE_INSTALLED_RUNTIME_VERSION to use the major version of the installed Runtime.
Return Value
If the specified product code has a valid license, this function returns TRUE. If the specified product code does not have a valid license, this function returns FALSE. Call GetLastError to obtain an error code.
Possible error codes:
| Error code | Meaning |
|---|---|
|
RT_ERROR_NO_LICENSE |
The specified product code does not have a valid license. |
|
RT_ERROR_NO_RUNTIME_LICENSE |
No valid licenses are present on the system. |
Remarks
RtGetLincenseStatus supports these macros:
| Macro | Description |
|---|---|
|
RtIsNetworkLicensed |
Verifies whether a specified wRTOS network version has a valid license. If the specified version is licensed, it returns TRUE. If the specified version is not licensed, it returns FALSE. |
|
RtIsRuntimeLicensed |
Verifies whether a specified wRTOS Runtime has a valid license. If the specified version is licensed, it returns TRUE. If the specified version is not licensed, it returns FALSE. |
Requirements
| Minimum supported version | Header | Library |
|---|---|---|
|
wRTOS 1.0 SDK |
RtApi.h |
RtApi.lib (Windows), Startup.lib (RTSS) |