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