Skip to main content
Open topic with navigation CAPL Functions » ISO11783 » Virtual Terminal Interaction Layer (VT IL) » VTIL_EnableNameManagement

​
VTIL_EnableNameManagement

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

dword VTIL_EnableNameManagement(dword enable);
dword VTIL_EnableNameManagement(dword enable, dword bitMask);

​
Description

This function activates the name management of a node. Not until the name management is activated another node can change the device name of this node by sending a name management message.

​
Parameters

  • enable
    • 1: activate the name management
    • 0: deactivates the name management
  • bitmask
    • Parts of the device name that are allowed to be changed:
      • bit 0 (LSB): Arbitrary Address Capable
      • bit 1: Industry Group
      • bit 2: System Instance
      • bit 3: System
      • bit 4: Function
      • bit 5: Function Instance
      • bit 6: ECU Instance
      • bit 7 (MSB): Manufacturer Code

​
Return Values

0 on success or IL Error Code

​
Example

//allow every component to be changed except arbitrary address capable flag
VTIL_EnableNameManagement(1, 0xFE);