# SimConnect_RemoveClientEvent<no value>
The **SimConnect\_RemoveClientEvent** function is used to remove a client defined event from a notification group.

 

##### Syntax

``` cpp
HRESULT SimConnect_RemoveClientEvent(
      HANDLE  hSimConnect,
      SIMCONNECT_NOTIFICATION_GROUP_ID  GroupID,
      SIMCONNECT_CLIENT_EVENT_ID  EventID
      );
```

 

##### Parameters

{{< table-wrapper >}}

| Parameter     | Description                                                                           | Type    |
|---------------|---------------------------------------------------------------------------------------|---------|
| *hSimConnect* | Handle to a SimConnect object.                                                        | Integer |
| *GroupID*     | Specifies the ID of the client defined group.                                         | Integer |
| *EventID*     | Specifies the ID of the client defined event ID that is to be removed from the group. | Integer |

{{< /table-wrapper >}}


 

##### Return Values

The function returns an **HRESULT**. Possible values include, but are not limited to, those in the following table.

{{< table-wrapper >}}

| Return value | Description             |
|--------------|-------------------------|
| S\_OK        | The function succeeded. |
| E\_FAIL      | The function failed.    |

{{< /table-wrapper >}}


 

##### Example

``` cpp
static enum EVENT_ID {
    EVENT_1,
    EVENT_2
    EVENT_3
    }; 
static enum GROUP_ID {
    GROUP_1,
    };
hr = SimConnect_AddClientEventToNotificationGroup(hSimConnect, GROUP_1, EVENT_1);
hr = SimConnect_AddClientEventToNotificationGroup(hSimConnect, GROUP_1, EVENT_2);
hr = SimConnect_AddClientEventToNotificationGroup(hSimConnect, GROUP_1, EVENT_3, TRUE);
hr = SimConnect_RemoveClientEvent(hSimConnect, GROUP_1, EVENT_2);
```

 

##### Remarks

Use this function to permanently remove the client event. There is no reliable procedure to temporarily turn off a client event.