CAPLfunctionSomeIpReleaseMessage

SomeIpReleaseMessage

Valid for: CANoe DE • CANoe4SW DE

Function Syntax

long SomeIpReleaseMessage( dword messageHandle );

Description

This function is used to delete a message that was created with SomeIpCreateMessage, for example.

Parameters

• messageHandle: Handle of the message that was created with SomeIpCreateMessage, for example.

Return Values

• 0: The function was successfully executed
• >0: Error code

Example

on key 's'
{
  DWORD messageId = 0x12340004; // service ID = 0x1234, method ID = 0x0004
  DWORD requestId = 0; // client ID = 0, session ID = 0
  DWORD protocolVersion = 1;
  DWORD interfaceVersion = 1;
  DWORD messageType = 0x2; // notification message
  DWORD returnCode = 0; // not available
  DWORD aep = 0; // application endpoint handle
  DWORD messageHandle = 0; // handle of the created SOME/IP message
  BYTE payload[5]; // the message payload
  DWORD count = 0; // a simple counter

  // initialize the payload
  count = 0;
  payload[count++] = 0x11;
  payload[count++] = 0x22;
  payload[count++] = 0x33;
  payload[count++] = 0x44;
  payload[count++] = 0x55;

  // open application endpoint
  aep = SomeIpOpenLocalApplicationEndpoint(17, 50002);

  // create the SOME/IP message itself and set the message payload
  messageHandle = SomeIpCreateMessage(messageId,requestId,protocolVersion,interfaceVersion,messageType,returnCode);
  SomeIpSetData(messageHandle,elcount(payload),payload);

  // send the SOME/IP message
  SomeIpOutputMessage(aep,0xFFFFFFFF,40001,messageHandle);

  // release the some IP message
  SomeIpReleaseMessage(messageHandle);
}

See Also

SomeIpCreateMessage | CAPLfunctionSomeIpCreateMessage.htm#aanchor13340
SomeIpOutputMessage | CAPLfunctionSomeIpOutputMessage.htm#aanchor11364
SomeIpPostMessage | CAPLfunctionSomeIpPostMessage.htm#aanchor12878
SomeIpReleaseMessage | #aanchor15413