CAPLfunctionIso11783OPSetProperty

Iso11783OPSetProperty

Valid for: CANoe DE • CANoe4SW DE

Function Syntax

long Iso11783OPSetProperty( dword ecuHandle, char propertyName[], long newValue );

Description

The function sets a property of the Object Pool API, i.e. the supported Virtual Terminal version.

Parameters

• ecuHandle: Handle of the ECU. The handle must be created with Iso11783CreateECU.

• propertyName: Key of the information to set:

  • Version: Supported version of the ISO11783 Virtual Terminal specification. Supported values: 2, 3 (default), 4 and 5. If used, the version value obtained from the database (node attribute ISO11783OPVersion) is overwritten.
  • DebugLevel: Controls the output to the Write Window. Supported values:
    • 0: No output
    • 1: Only errors
    • 2: Warnings and errors
    • 3: Information, warnings and errors
  • SendPreferredAssignmentEvenIfEmpty: Enforces sending of the Preferred Assigning message to the Virtual Terminal, even if no of auxiliary function has a preferred assigned auxiliary input. Supported values:
    • 0: Preferred Assigning message is sent to the Virtual Terminal if at least one preferred assignment exists
    • 1: Preferred Assigning message is sent to the Virtual Terminal even if no preferred assignment exists

• newValue: New value for the parameter

Return Values

• 0: Function has been executed successfully
• < 0: An error has occurred, see error codes
• -102: Invalid parameter
• -1113: Unknown property

Example

Iso11783OPSetProperty( handle, "Version", 3 );