RtIsAppRunnable
RtIsAppRunnable returns whether the provided RTSS application binary can run. This means it has been built using a valid wRTOS SDK license, and that there is a valid license for the feature on the system with the given majorVersion.
Syntax
BOOL RtIsAppRunnable(
[in] LPTSTR lpApplicationPath,
[in] LPTSTR lpFeatureName,
[in] DWORD majorVersion
);
Parameters
[in] lpApplicationPath
The absolute path name of an RTSS application.
[in] lpFeatureName
A string specifying a product feature code. The table below lists the common product codes for wRTOS:
| 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 wRTOS Runtime to validate.
| Runtime version | majorVersion value |
|---|---|
|
wRTOS 1.x |
1 |
|
Currently installed version |
0 |
Return Value
If the given feature has a valid license and the application can run with the given product feature code, it returns TRUE. If the function fails, it returns FALSE. Call GetLastError to obtain an error code.
Remarks
This function returns FALSE when it is passed a binary that is not an RTSS application.
Requirements
| Minimum supported version | Header | Library |
|---|---|---|
|
wRTOS 1.0 SDK |
RtApi.h |
RtApi.lib (Windows), Startup.lib (RTSS) |