Skip to main content
Open topic with navigation

​
TCIL_RequestVersion

CAPL Functions » ISO11783 » Task Controller Interaction Layer (TC IL) » TCIL_RequestVersion

​
Function Syntax

  • long TCIL_RequestVersion(dbNode client); // form 1
  • long TCIL_RequestVersion(dword addressClient); // form 2
  • long TCIL_RequestVersion(dbNode tc, dbNode client); // form 3
  • long TCIL_RequestVersion(dbNode tc, dword addressClient); // form 4

​
Description

This function requests the Version message from the client.

​
Parameters

  • tc: Task Controller simulation node to apply the function.
  • client: Task Controller client node the TC sends the Request Version to.
  • addressClient: Address of the Task Controller client node the TC sends the Request Version to.

​
Return Values

  • 0: Property has been set successfully
  • < 0: An error has occurred: IL Error Code

​
Example

Example form 3 
long result;
result = TCIL_RequestVersion(TC, Sprayer);
switch (result)
{
  case     0: TestStepPass(); break;
  case -2202: TestStepFail("Function is not available in passive mode of the TC IL!"); break;
  case -2204: TestStepFail("Node 'Sprayer' is no client device!"); break;
  case -2210: TestStepFail("Failed to send Request Version message!"); break;
  default:    TestStepFail("Unexpected error"); break;
}