CAPLfunctionAREthRemoveProvidedEventGroup

AREthRemoveProvidedEventGroup

Valid for: CANoe DE • CANoe4SW DE

Function Syntax

long AREthRemoveProvidedEventGroup( dword pevgHandle );

Description

Removes an Event Group from a Provided Service Instance. The Event Group was previously added by AREthAddProvidedEventGroup.

The Events and Fields assigned to the Event Group are not deleted when the Event Group is closed.

Parameters

• pevgHandle: Handle of the Event Group (see AREthAddProvidedEventGroup).

Return Values

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

Example

on key 't'
{
  dword aep; // Application Endpoint handle
  dword psi; // provided service handle
  dword peg; // provided Eventgroup handle

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

  // create service
  psi = AREthCreateProvidedServiceInstance(aep,10,1);

  // create Eventgroup
  peg = AREthAddProvidedEventGroup(psi,1);

  // ... do something here

  // remove the Eventgroup
  AREthRemoveProvidedEventGroup(peg);

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

See Also