# SimConnect_ClearInputGroup<no value>
The **SimConnect\_ClearInputGroup** function is used to remove all the input events from a specified input group object.

 

##### Syntax

``` cpp
HRESULT SimConnect_ClearInputGroup(
    HANDLE  hSimConnect,
    SIMCONNECT_INPUT_GROUP_ID  GroupID
    );
```

 

##### Parameters

{{< table-wrapper >}}

| Parameter     | Description                                                                                | Type    |
|---------------|--------------------------------------------------------------------------------------------|---------|
| *hSimConnect* | Handle to a SimConnect object.                                                             | Integer |
| *GroupID*     | Specifies the ID of the client defined input group that is to have all its events removed. | 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 INPUT_ID {
    INPUT_1,
    };
static enum EVENT_ID {
    EVENT_1,
    };
hr = SimConnect_MapClientEventToSimEvent(hSimConnect, EVENT_1, "parking_brakes");
hr = SimConnect_MapInputEventToClientEvent(hSimConnect, INPUT_1, "a+B", EVENT_1);
      ....
hr = SimConnect_ClearInputGroup(hSimConnect, INPUT_1);
```

 

##### Remarks

Use this function to permanently delete an input group. Use the [SimConnect\_SetInputGroupState](simconnect-setinputgroupstate/) function to temporarily suspend input group notifications.