TraceMgrPacketRestore (FUN)

FUNCTION TraceMgrPacketRestore : RTS_IEC_HANDLE

Loads a trace packet from a trace file. Both the trace configuration and the current trace values are restored.

InOut:

Scope

Name

Type

Comment

Return

TraceMgrPacketRestore

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

  • ERR_PARAMETER if hPacket is not a valid handle, or if pszFileName is not a valid file path

  • ERR_NOMEMORY if the memory is not sufficient for opening the file

  • ERR_NOT_SUPPORTED if reading from files is not supported by the runtime system or if an addressing mode is not supported (e.g. symbolic access)

  • ERR_NO_OBJECT if opening the file failed

  • ERR_FAILED if opening the file failed

Inout Const

pszFileName

STRING

The file path (in)

Inout

pResult

RTS_IEC_RESULT

The result code (out)