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).

 

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). Examples of aircraft titles: title=Boeing 747-8f Asobo title=DA62 Asobo title=VL3 Asobo	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.