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

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