SimConnect_AICreateNonATCAircraft
The SimConnect_AICreateNonATCAircraft function is used to create an aircraft that is not flying under ATC control (so is typically flying under VFR rules).
NOTE: 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.
Syntax
HRESULT SimConnect_AICreateNonATCAircraft(
HANDLE hSimConnect,
const char* szContainerTitle,
const char* szTailNumber,
SIMCONNECT_DATA_INITPOSITION InitPos,
SIMCONNECT_DATA_REQUEST_ID RequestID
);
Parameters
| Parameter | Description | Type |
|---|---|---|
| hSimConnect | Handle to a SimConnect object. | Integer |
| szContainerTitle |
Null-terminated string containing the container title. The container title is found in the aircraft.cfg file. Alternatively, the aircraft title can be obtained via the Aircraft Selector (DevMode->Windows->Aircraft selector). Finally, the information can be found using the
|
String |
| szTailNumber | Null-terminated string containing the tail number. This should have a maximum of 12 characters. | String |
| InitPos | Specifies the initial position, using a SIMCONNECT_DATA_INITPOSITION structure. | Integer |
| RequestID | Specifies the client defined request ID. | String |
Return Values
The function returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return value | Description |
|---|---|
| S_OK | The function succeeded. |
| E_FAIL | The function failed. |
Remarks
A non-ATC 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 enum for more details):
SIMCONNECT_EXCEPTION_CREATE_OBJECT_FAILED
Refer to the remarks for SimConnect_AICreateEnrouteATCAircraft.
Related Topics