Skip to main content

​
AREthGetDestinationAddress

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

  • dword AREthGetDestinationAddress ( dword messageHandle ); // form 1
  • long AREthGetDestinationAddress ( dword messageHandle, byte ipv6Address[] ); // form 2

​
Description

This function returns the IPv4 destination address.

​
Parameters

  • messageHandle: Handle of the received SOME/IP message.
    • Note: This function can only be called within the OnAREthMessage callback function.
  • ipv6Address: The parameter to which the IPv6 address will be written to.

​
Return Values

  • IPv4 destination address (Network Byte Order)
  • In the event of an error, the function returns the value 0. The AREthGetLastError function can then be used to check whether the value is valid or an error has occurred.
    • Note: The IpGetAddressAsString function can be used to convert the numerical return value to a character string in shorthand notation.
  • 0: The function was successfully executed
  • >0: Error code

​
Example

void OnAREthMessage( dword messageHandle )
{
  dword dstAddress    = 0;
  LONG  errorCode     = 0;
  LONG  errorOccured  = 0;
  char  buffer[100];

  // get data from SOME/IP message
  if((dstAddress = AREthGetDestinationAddress(messageHandle)) == 0)
  {
    // check if last function was executed correct
    if((errorCode = AREthGetLastError()) != 0)
    {
      write("AUTOSAR Eth IL error occured: Error code: %d", errorCode);
      errorOccured = 1;
    }
  }

  if(errorOccured == 0)
  {
    IpGetAddressAsString(dstAddress, buffer, elcount(buffer));
    write("SOME/IP message received. Destination address: %s", buffer);
  }
}