INtime SDK Help
load_RT_scope (INscope)
INtime 7.x SDK > About INtime > Other system libraries > INscope API > load_RT_scope (INscope)

_rt_buffer_sizeLoads the INscope RT Server Component (rtscope.rta) on the current INtime node and performs the initial handshake required before any other INscope API calls can be made. If rtscope.rta is already running, the call fails.

int load_RT_scope(
    char * rtscopePath,      // Path to rtscope.rta, or NULL for default
    DWORD  rtscopeTraceSize  // Trace buffer size in bytes, or 0 for default
);

Parameters

rtscopePath
Full path to rtscope.rta. If NULL or an empty string, the function locates rtscope.rta using the INTIME environment variable (%INTIME%\bin\rtscope.rta).
rtscopeTraceSize
Requested trace buffer size, in bytes. The value is converted to kilobytes and passed to rtscope at startup. If 0, rtscope uses its default trace buffer size.

Return Values

1 (non-zero)
Success. rtscope.rta is loaded and ready.
0 (zero)
Failure. Call GetLastRtError() for details:
E_STATE (7)
rtscope.rta was already running.
E_EXIST (6)
rtscope.rta was found but failed to start, or did not respond within the timeout period.

Requirements

Versions Defined in Include Link to
INtime 7.1 traceapi.h traceapihlpr.lib
See Also