# SimConnect_EnumerateSimObjectsAndLiveries<no value>
The **SimConnect\_EnumerateSimObjectsAndLiveries** function is used to retrieve the list of spawnable SimObjects (and the name of their livery if applicable) that can be used with `SimConnect_AICreate_*` functions.

 

##### Syntax

``` cpp
HRESULT SimConnect_EnumerateSimObjectsAndLiveries(
    HANDLE  hSimConnect,
    SIMCONNECT_DATA_REQUEST_ID  RequestID,
    SIMCONNECT_SIMOBJECT_TYPE Type
    );
```

 

##### Parameters

<table><thead><tr class="header"><th>Parameter</th><th>Description</th><th>Type</th></tr></thead><tbody><tr class="odd"><td><em>hSimConnect</em></td><td>Handle to a SimConnect object.</td><td>Integer</td></tr><tr class="even"><td><em>RequestId</em></td><td>Specifies the client defined request ID.</td><td>Integer</td></tr><tr class="odd"><td><em>Type</em></td><td><p>Specifies the type of SimObjects that will be retrieved by the function:</p><ul><li><code>SIMCONNECT_SIMOBJECT_TYPE_USER</code>: SimObject types selectable by the user (airplane, helicopter and hot air balloon)</li><li><code>SIMCONNECT_SIMOBJECT_TYPE_ALL</code>: All types listed in this note.</li><li><code>SIMCONNECT_SIMOBJECT_TYPE_AIRCRAFT</code>: Retrieve only airplanes.</li><li><code>SIMCONNECT_SIMOBJECT_TYPE_HELICOPTER</code>: Retrieve only helicopters.</li><li><code>SIMCONNECT_SIMOBJECT_TYPE_BOAT</code>: Retrieve only boats.</li><li><code>SIMCONNECT_SIMOBJECT_TYPE_GROUND</code>: Retrieve only ground vehicles.</li><li><code>SIMCONNECT_SIMOBJECT_TYPE_HOT_AIR_BALLOON</code>: Retrieve only hot air balloons.</li><li><code>SIMCONNECT_SIMOBJECT_TYPE_ANIMAL</code>: Retrieve only animals.</li><li><code>SIMCONNECT_SIMOBJECT_TYPE_USER_AVATAR</code>: Retrieve the user avatar.</li></ul></td><td>Integer</td></tr></tbody></table>

 

##### 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 >}}


 

##### Remarks

This function should be used to retrieve the list of spawnable SimObjects (and the name of their liveries if applicable) that are mandatory information used by `SimConnect_AICreate*` functions. This function can send two kinds of messages :

-   A `SIMCONNECT_RECV_ENUMERATE_SIMOBJECT_AND_LIVERY_LIST` message which contains the list (or a part of the list) of all possible combinations.
-   A `SIMCONNECT_EXCEPTION` message with the `SIMCONNECT_EXCPETION_INTERNAL` ID, which implies that something went wrong while creating the list to retrieve to the client (which should never happen).