# SimConnect_AICreateSimulatedObject_EX1<no value>
The **SimConnect\_AICreateSimulatedObject\_EX1** function is used to create AI controlled objects other than aircraft. This function can be used with both *legacy* SimObjects, and **modular** SimObjects.

 

##### Syntax

``` cpp
HRESULT SimConnect_AICreateSimulatedObject_EX1(
    HANDLE  hSimConnect,
    const char*  szContainerTitle,
    const char* szLivery,
    SIMCONNECT_DATA_INITPOSITION  InitPos,
    SIMCONNECT_DATA_REQUEST_ID  RequestID
    );
```

 

##### 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>szContainerTitle</em></td><td><p>Null-terminated string containing the container title. The container title is found in the <a href="../../../../content-configuration/cfg-files/aircraft_cfg/#title">title</a> parameter of the <code>aircraft.cfg</code> file, or alternatively, you can find it from the list found in the <a href="../../../../2_DevMode/Menus/Tools/#aircraft_capture">Aircraft Capture Tool</a>.</p><p><strong>IMPORTANT!</strong> This title must be in an aircraft <a href="../../../../content-configuration/modular-simobjects/Modular_SimObject_Project_Structure/#presets">Preset</a>.You may also retrieve the information with SimConnect using the <code>SimConnect_EnumerateSimObjectsAndLiveries</code> function.</p><p>  

Examples of aircraft titles:</p><ol><li><code>title=Boeing 747-8f Asobo</code></li><li><code>title=DA62 Asobo</code></li><li><code>title=VL3 Asobo</code></li></ol></td><td>String</td></tr><tr class="odd"><td><em>szLivery</em></td><td><p>Null-terminated string containing the livery name. This field is only required when checking <strong>modular</strong> SimObjects, since their liveries are dynamically handled and do not have a unique <a href="../../../../content-configuration/cfg-files/aircraft_cfg/#title">title</a> parameter like legacy aircraft.</p><p>This parameter can be set to either the <em>name</em> of the livery as defined in the <code>name</code> parameter of the <code>livery.cfg</code>, or to the <em>folder name</em> of the livery in the package. Note that you can also get the livery name using the <code>SimConnect_EnumerateSimObjectsAndLiveries</code> function.</p><p>The function will check for the <strong>folder</strong> first, then the <strong>parameter name</strong> second, and if the given name is not found in either location, then the default livery will be used.</p></td><td>String</td></tr><tr class="even"><td><em>InitPos</em></td><td>This a <code>SIMCONNECT_DATA_INITPOSITION</code> struct containing the data referring to the spawn position of the SimObject.</td><td>Struct</td></tr><tr class="odd"><td><em>RequestID</em></td><td>Specifies the client defined request ID.</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 can be used to create a stationary aircraft (such as an unflyable aircraft on display outside a flight museum), but is typically intended to create simulation objects other than aircraft (such as ground vehicles, boats, and a number of special objects such as humpback whales).

 

The following exception can be created by this function (refer to the [SIMCONNECT\_EXCEPTION](../structures-and-enumerations/simconnect-exception/) enum for more details):

-   `SIMCONNECT_EXCEPTION_CREATE_OBJECT_FAILED`