Dynamically loads a Real-time Shared Library module. When successfully loaded, the operating system calls the module's RslMain entry function with a reason code of RSL_PROCESS_ATTACH. If a module with the same name is already loaded into memory, that module is remapped into the calling process without reloading the file.

If the RslMain function returns a value of FALSE, then the call to LoadRtLibrary fails.

If the process has been created with the PROC_STRICTRSL flag set, then if a module is being loaded with a full pathname, a test is made against the full pathname of any loaded module rather than just the filename before deciding to load the module. This allows a process to choose to load an RSL of a different version compared to an already-loaded module of the same name.

RTHANDLE LoadRtLibrary(
    char *lpModuleName
);

Parameters

lpModuleName

String containing the filename of the module. The filename in this case may be only the filename without path information. In this case a search is performed in the following directories:

• The directory where the original .RTA file was loaded from
• The process's current directory.
• INtime for Windows:
• • The path given by the registry value HKLM\SOFTWARE\TenAsys\INtime\RTAppLoader\RSLPath, if it exists. This value may be of type REG_SZ or REG_MULTI_SZ. If it is of type REG_MULTI_SZ then it may contain multiple paths which are searched in the order of appearance.
  • The directory %INTIME%\rt\lib
  • The directory %INTIME%\bin
• INtime Distributed RTOS:
  • The paths given by the PATH environment variable. The value is a colon-separated list of paths, defined in the [CLIB] section of the configuration file for the node.

If a full path is given in lpModuleName, then no search is performed.

Return Values

The handle associated with the loaded module.

Success.

NULL_RTHANDLE

Failure. To determine the status, call GetLastRtError.

Requirements