# SimConnect_AICreateParkedATCAircraft_EX1<no value>
The **SimConnect\_AICreateParkedATCAircraft** function is used to create an AI controlled aircraft that is currently parked and does not have a flight plan. This function can be used with both *legacy* SimObjects, and **modular** SimObjects.

 

##### Syntax

``` cpp
HRESULT SimConnect_AICreateParkedATCAircraft_EX1(
    HANDLE  hSimConnect,
    const char*  szContainerTitle,
    const char*  szLivery,
    const char*  szTailNumber,
    const char*  szAirportID,
    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>szTailNumber</em></td><td>Null-terminated string containing the tail number. This should have a maximum of 12 characters.</td><td>String</td></tr><tr class="odd"><td><em>szAirportID</em></td><td>Null-terminated string containing the airport ID. This is the <a href="#" class="glossterm">ICAO code</a> string, for example, KSEA for SeaTac International.</td><td>String</td></tr><tr class="even"><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

Calling this function is no guarantee that there is sufficient parking space at the specified airport. An error will be returned if there is insufficient parking space, and an aircraft will not be created. The following exceptions can be created by this function (refer to the [SIMCONNECT\_EXCEPTION](../structures-and-enumerations/simconnect-exception/) enum for more details):

-   `SIMCONNECT_EXCEPTION_OBJECT_OUTSIDE_REALITY_BUBBLE`
-   `SIMCONNECT_EXCEPTION_OBJECT_CONTAINER`
-   `SIMCONNECT_EXCEPTION_OBJECT_AI`
-   `SIMCONNECT_EXCEPTION_OBJECT_ATC`
-   `SIMCONNECT_EXCEPTION_OBJECT_SCHEDULE`
-   `SIMCONNECT_EXCEPTION_CREATE_OBJECT_FAILED`

 

After creating an aircraft with this function, a call to [SimConnect\_AISetAircraftFlightPlan](simconnect-aisetaircraftflightplan/) will set the aircraft in motion.

 

When allocating a parking space to an aircraft, the simulation uses a radius based on half the wingspan defined in the `[AIRPLANE_GEOMETRY]` section of the `flight_model.cfg`.

 

Refer also to the remarks for [SimConnect\_AICreateEnrouteATCAircraft\_EX1](simconnect-aicreateenrouteatcaircraft-ex1/).