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