RtGetLicenseStatus

RtGetLicenseStatus returns whether the specified version of a product code has a valid license.

Syntax

Copy
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)