RtkIsAppRunnable

RtkIsAppRunnable is the RTKAPI equivalent of RtIsAppRunnable. It returns whether the provided RTSS application binary can run. This means it has been built using a valid RTX64 SDK license, and that there is a valid license for the feature on the system with the given majorVersion.

RtkIsAppRunnable can only be used in RTK drivers. It cannot be used in Windows or RTSS applications.

Syntax

NTSTATUS RtkIsAppRunnable(
	BOOLEAN* pResult,
	PUNICODE_STRING pApplicationPath,
	PUNICODE_STRING pFeatureName,
	unsigned int majorVersion
);

Parameters

pResult

A pointer to memory to fill with the API result if the API returns STATUS_SUCCESS. Must be allocated by the caller or the API will return STATUS_INVALID_PARAMETER. If the provided binary is determined to be runnable, a value of TRUE will be written into the provided memory, otherwise FALSE is returned.

pApplicationPath

The absolute path name of an RTSS application. This parameter can never be NULL. If NULL is passed, RtkIsAppRunnable returns STATUS_INVALID_PARAMETER

pFeatureName

A string specifying a product feature code. The table below lists the common product codes for RTX64:

Product Code	Description
RTX64	RTX64 Subsystem
TCP64	RT-TCP/IP Stack

majorVersion

The major version number for the product feature given in parameter pFeatureName.

Runtime Version	majorVersion Value
RTX64 3.0	3
RTX64 2014 (includes Service Packs)	2
Currently installed version	0

Return Value

Returns an error code:

Error Code	Description
STATUS_SUCCESS	The call has succeeded
STATUS_INTERNAL_ERROR	The call failed with an internal system error
STATUS_INVALID_PARAMETER	An invalid <length> parameter was passed, or one of the required pointer parameters was NULL
STATUS_DRIVER_INTERNAL_ERROR	The call failed with an internal driver error

Requirements

Minimum Supported Version	RTX64 3.0
Header	RtkApi.h
Library	RtkApi.lib