# SimConnect_AICreateNonATCAircraft<no value>
The **SimConnect\_AICreateNonATCAircraft** function is used to create an aircraft that is not flying under {{< glossterm >}}atc{{< /glossterm >}} control (so is typically flying under {{< glossterm >}}vfr{{< /glossterm >}} rules).

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

This function is a **legacy** function and only works with **non-modular aircraft**. In Microsoft Flight Simulator 2024 we recommend you use `SimConnect_AICreateNonATCAircraft_EX1`, which can be used with legacy **and** modular aircraft.

{{< /callout >}}

 

##### Syntax

``` cpp
HRESULT SimConnect_AICreateNonATCAircraft(
    HANDLE  hSimConnect,
    const char*  szContainerTitle,
    const char*  szTailNumber,
    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/ai_cfg.htm">aircraft.cfg</a> file.</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>.Alternatively, the aircraft title can be obtained via the Aircraft Selector (<em>DevMode</em>-&gt;<em>Windows</em>-&gt;<em>Aircraft</em> selector). Finally, the information can be found using the <code>SimConnect_EnumerateSimObjectsAndLiveries</code> function.  

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>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="even"><td><em>InitPos</em></td><td>Specifies the initial position, using a SIMCONNECT_DATA_INITPOSITION structure.</td><td>Integer</td></tr><tr class="odd"><td><em>RequestID</em></td><td>Specifies the client defined request ID.</td><td>String</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

A non-{{< glossterm >}}atc{{< /glossterm >}} aircraft can be on the ground or airborne when it is created by this function. The following exception can be caused by this function (refer to the [SIMCONNECT\_EXCEPTION](../structures-and-enumerations/simconnect-exception/) enum for more details):

-   `SIMCONNECT_EXCEPTION_CREATE_OBJECT_FAILED`

 

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