INtime SDK Help
GetRtModuleFilename
INtime SDK v7.1 > About INtime > INtime Kernel > RSLs (real-time shared libraries) > GetRtModuleFilename

Returns the full path name of a loaded module, given its handle. If a NULL handle is given then returns the full pathname of the current application file (.RTA).

DWORD GetRtModuleFilename(
    RTHANDLE hModule, 
    char *lpModuleName,
    DWORD cbSize
);

Parameters

hModule
Handle for a loaded RSL module, or NULL_RTHANDLE.
lpModuleName
Pointer to a buffer which will receive the module name.
cbSize
The size, in bytes, of the buffer pointed to by lpModuleName.

Return Values

The length of the returned name, not including the terminating null. If the buffer would overflow, the string is truncated at the size of the buffer, including the terminating null, the value of cbSize is returned and the last error value is set to E_LIMIT.
Success.
0 (zero)
Failure. To determine the status, call GetLastRtError.

Requirements

Versions Defined in Include Link to
INtime 3.1 intime/rt/include/rtbase.h rt.h rt.lib
See Also