Skip to main content

​
SomeIpRemoveConsumedEventGroup

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

LONG SomeIpRemoveConsumedEventGroup( dword cevgHandle );

​
Description

Removes an Event Group from a Consumed Service Instance. The Event Group was previously added by SomeIpAddConsumedEventGroup. The Events, fields, and methods assigned to the Event Group are not deleted when the Eventgroup is closed.

​
Parameters

  • cevgHandle: Handle of the Consumed Event Group.

​
Return Values

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

​
Example

on key 'c'
{
  DWORD aep; // Application Endpoint handle
  DWORD csi; // consumed Service Instance handle
  DWORD ceg; // consumed Eventgroup handle

  // open an Application Endpoint
  aep = SomeIpOpenLocalApplicationEndpoint(17, 50002);

  // create Service Instance
  csi = SomeIpCreateConsumedServiceInstance(aep,10,1);

  // create Eventgroup
  ceg = SomeIpAddConsumedEventGroup(csi,1);

  // ... do something here

  // release the consumed Service Instance
  SomeIpRemoveConsumedEventGroup(ceg);

  // ... Application Endpoint and provided Service Instance can still be used here
}
See Also