TraceMgrRecordGetFirst (FUN)

FUNCTION TraceMgrRecordGetFirst : RTS_IEC_HANDLE

Returns the first trace record of a trace packet. This function can be used together with TraceMgrRecordGetNext to iterate through all trace records of a packet.

InOut:

Scope

Name

Type

Comment

Return

TraceMgrRecordGetFirst

RTS_IEC_HANDLE
Returns the runtime system error code (see CmpErrors.library):

  • ERR_PARAMETER if hPacket is not a valid packet handle

  • ERR_NO_OBJECT if the packet has no trace record

Input

hPacket

RTS_IEC_HANDLE

The trace packet handle

Inout

pResult

RTS_IEC_RESULT

The result code (out)