Sign in to follow this  
dragonflightdesign

SimConnect Exceptions displayed as a webpage. Code in topic.

Recommended Posts

I'm sure Bill will tell me that there's a far better way of doing this but... :smile: If you copy and paste the html code below and save it as <filename>.html it will create a webpage with the SimConnect exceptions set up as hyperlinks to the error explanation. I got fed-up with continually trying to find the information in both the FSX and P3D SDK documentation, so I turned it into a webpage. No nasty Javascript or CSS, just simple, pure HTML 4.0.

 

 

 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>SimConnect Exceptions</TITLE>

</HEAD>

<tr><td><A NAME = "top"><h3>SIMCONNECT_EXCEPTION</h3></td></tr>

<p>The SIMCONNECT_EXCEPTION enumeration type is used with the SIMCONNECT_RECV_EXCEPTION structure to return information on an error that has occurred.</p>

<p>enum SIMCONNECT_EXCEPTION{
<table>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#0">SIMCONNECT_EXCEPTION_NONE = 0,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#1">SIMCONNECT_EXCEPTION_ERROR = 1,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#2">SIMCONNECT_EXCEPTION_SIZE_MISMATCH = 2,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#3">SIMCONNECT_EXCEPTION_UNRECOGNIZED_ID = 3,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#4">SIMCONNECT_EXCEPTION_UNOPENED = 4,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#5">SIMCONNECT_EXCEPTION_VERSION_MISMATCH = 5,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#6">SIMCONNECT_EXCEPTION_TOO_MANY_GROUPS = 6,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#7">SIMCONNECT_EXCEPTION_NAME_UNRECOGNIZED = 7,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#8">SIMCONNECT_EXCEPTION_TOO_MANY_EVENT_NAMES = 8,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#9">SIMCONNECT_EXCEPTION_EVENT_ID_DUPLICATE = 9,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#10">SIMCONNECT_EXCEPTION_TOO_MANY_MAPS = 10,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#11">SIMCONNECT_EXCEPTION_TOO_MANY_OBJECTS = 11,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#12">SIMCONNECT_EXCEPTION_TOO_MANY_REQUESTS = 12,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#13">SIMCONNECT_EXCEPTION_WEATHER_INVALID_PORT = 13,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#14">SIMCONNECT_EXCEPTION_WEATHER_INVALID_METAR = 14,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#15">SIMCONNECT_EXCEPTION_WEATHER_UNABLE_TO_GET_OBSERVATION = 15,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#16">SIMCONNECT_EXCEPTION_WEATHER_UNABLE_TO_CREATE_STATION = 16,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#17">SIMCONNECT_EXCEPTION_WEATHER_UNABLE_TO_REMOVE_STATION = 17,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#18">SIMCONNECT_EXCEPTION_INVALID_DATA_TYPE = 18,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#19">SIMCONNECT_EXCEPTION_INVALID_DATA_SIZE = 19,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#20">SIMCONNECT_EXCEPTION_DATA_ERROR = 20,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#21">SIMCONNECT_EXCEPTION_INVALID_ARRAY = 21,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#22">SIMCONNECT_EXCEPTION_CREATE_OBJECT_FAILED = 22,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#23">SIMCONNECT_EXCEPTION_LOAD_FLIGHTPLAN_FAILED = 23,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#24">SIMCONNECT_EXCEPTION_OPERATION_INVALID_FOR_OJBECT_TYPE = 24,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#25">SIMCONNECT_EXCEPTION_ILLEGAL_OPERATION = 25,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#26">SIMCONNECT_EXCEPTION_ALREADY_SUBSCRIBED = 26,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#27">SIMCONNECT_EXCEPTION_INVALID_ENUM = 27,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#28">SIMCONNECT_EXCEPTION_DEFINITION_ERROR = 28,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#29">SIMCONNECT_EXCEPTION_DUPLICATE_ID = 29,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#30">SIMCONNECT_EXCEPTION_DATUM_ID = 30,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#31">SIMCONNECT_EXCEPTION_OUT_OF_BOUNDS = 31,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#32">SIMCONNECT_EXCEPTION_ALREADY_CREATED = 32,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#33">SIMCONNECT_EXCEPTION_OBJECT_OUTSIDE_REALITY_BUBBLE = 33,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#34">SIMCONNECT_EXCEPTION_OBJECT_CONTAINER = 34,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#35">SIMCONNECT_EXCEPTION_OBJECT_AI = 35,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#36">SIMCONNECT_EXCEPTION_OBJECT_ATC = 36,</A></TD></TR>
    <TR><TD WIDTH=32></TD><TD><A HREF = "#37">SIMCONNECT_EXCEPTION_OBJECT_SCHEDULE = 37,</A></TD></TR>
</table>
};</p>

<h4>General Errors</h4>

<table>
<tr><td><A NAME = "0">SIMCONNECT_EXCEPTION_NONE</A></td></tr>
<tr><td><font color="gray">Specifies that there has not been an error. This value is not currently used.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "1">SIMCONNECT_EXCEPTION_ERROR</A></td></tr>
<tr><td><font color="gray">An unspecific error has occurred. This can be from incorrect flag settings, null or incorrect parameters, the need to have at least one up or down event with an input event, failed calls from the SimConnect server to the operating system, among other reasons.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "2">SIMCONNECT_EXCEPTION_SIZE_MISMATCH</A></td></tr>
<tr><td><font color="gray">Specifies the size of the data provided does not match the size required. This typically occurs when the wrong string length, fixed or variable, is involved.
</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "3">SIMCONNECT_EXCEPTION_UNRECOGNIZED_ID</A></td></tr>
<tr><td><font color="gray">Specifies that the client event, request ID, data definition ID, or object ID was not recognized.
</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "4">SIMCONNECT_EXCEPTION_UNOPENED</A></td></tr>
<tr><td><font color="gray">Specifies that communication with the SimConnect server has not been opened. This error is not currently used.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "5">SIMCONNECT_EXCEPTION_VERSION_MISMATCH</A></td></tr>
<tr><td><font color="gray">Specifies a versioning error has occurred. Typically this will occur when a client built on a newer version of the SimConnect client dll attempts to work with an older version of the SimConnect server.
</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "6">SIMCONNECT_EXCEPTION_TOO_MANY_GROUPS</A></td></tr>
<tr><td><font color="gray">Specifies that the maximum number of groups allowed has been reached. The maximum is 20.
</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "7">SIMCONNECT_EXCEPTION_NAME_UNRECOGNIZED</A></td></tr>
<tr><td><font color="gray">Specifies that the simulation event name (such as "brakes") is not recognized.
</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "8">SIMCONNECT_EXCEPTION_TOO_MANY_EVENT_NAMES</A></td></tr>
<tr><td><font color="gray">Specifies that the maximum number of event names allowed has been reached. The maximum is 1000.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "9">SIMCONNECT_EXCEPTION_EVENT_ID_DUPLICATE</A></td></tr>
<tr><td><font color="gray">Specifies that the event ID has been used already. This can occur with calls to SimConnect_MapClientEventToSimEvent, or SimConnect_SubscribeToSystemEvent.
<td></td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "10">SIMCONNECT_EXCEPTION_TOO_MANY_MAPS</A></td></tr>
<tr><td><font color="gray">Specifies that the maximum number of mappings allowed has been reached. The maximum is 20.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "11">SIMCONNECT_EXCEPTION_TOO_MANY_OBJECTS</A></td></tr>
<tr><td><font color="gray">Specifies that the maximum number of objects allowed has been reached. The maximum is 1000.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "12">SIMCONNECT_EXCEPTION_TOO_MANY_REQUESTS</A></td></tr>
<tr><td><font color="gray">Specifies that the maximum number of requests allowed has been reached. The maximum is 1000.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "18">SIMCONNECT_EXCEPTION_INVALID_DATA_TYPE</A></td></tr>
<tr><td><font color="gray">Specifies that the data type requested does not apply to the type of data requested. Typically this occurs with a fixed length string of the wrong length.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "19">SIMCONNECT_EXCEPTION_INVALID_DATA_SIZE</A></td></tr>
<tr><td><font color="gray">Specifies that the size of the data provided is not what is expected. This can occur when the size of a structure provided does not match the size given, or a null string entry is made for a menu or sub-menu entry text, or data with a size of zero is added to a data definition. It can also occur with an invalid request to SimConnect_CreateClientData.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "20">SIMCONNECT_EXCEPTION_DATA_ERROR</A></td></tr>
<tr><td><font color="gray">Specifies a generic data error. This error is used by the SimConnect_WeatherCreateThermal function to report incorrect parameters, such as negative radii or values greater than the maximum allowed. It is also used by the SimConnect_FlightSave and SimConnect_FlightLoad functions to report incorrect file types. It is also used by other functions to report that flags or reserved parameters have not been set to zero.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "21">SIMCONNECT_EXCEPTION_INVALID_ARRAY</A></td></tr>
<tr><td><font color="gray">Specifies an invalid array has been sent to the SimConnect_SetDataOnSimObject function.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "26">SIMCONNECT_EXCEPTION_ALREADY_SUBSCRIBED</A></td></tr>
<tr><td><font color="gray">Specifies that the client has already subscribed to that event.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "27">SIMCONNECT_EXCEPTION_INVALID_ENUM</A></td></tr>
<tr><td><font color="gray">Specifies that the member of the enumeration provided was not valid. Currently this is only used if an unknown type is provided to SimConnect_RequestDataOnSimObjectType.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "28">SIMCONNECT_EXCEPTION_DEFINITION_ERROR</A></td></tr>
<tr><td><font color="gray">Specifies that there is a problem with a data definition. Currently this is only used if a variable length definition is sent with SimConnect_RequestDataOnSimObject.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "29">SIMCONNECT_EXCEPTION_DUPLICATE_ID</A></td></tr>
<tr><td><font color="gray">Specifies that the ID has already been used. This can occur with menu IDs, or with the IDs provided to SimConnect_AddToDataDefinition, SimConnect_AddClientEventToNotificationGroup or SimConnect_MapClientDataNameToID.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "30">SIMCONNECT_EXCEPTION_DATUM_ID</A></td></tr>
<tr><td><font color="gray">Specifies that the datum ID is not recognized. This currently occurs with a call to the SimConnect_SetDataOnSimObject function.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "31">SIMCONNECT_EXCEPTION_OUT_OF_BOUNDS</A></td></tr>
<tr><td><font color="gray">Specifies that the radius given in the SimConnect_RequestDataOnSimObjectType was outside the acceptable range, or with an invalid request to SimConnect_CreateClientData.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "32">SIMCONNECT_EXCEPTION_ALREADY_CREATED</A></td></tr>
<tr><td><font color="gray">Specifies that a client data area with the name requested by a call to SimConnect_MapClientDataNameToID has already been created by another addon. Try again with a different name.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<h4>Weather System Errors</h4>

<table>
<tr><td><A NAME = "13">SIMCONNECT_EXCEPTION_WEATHER_INVALID_PORT</A></td></tr>
<tr><td><font color="gray">Specifies an invalid port number was requested.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "14">SIMCONNECT_EXCEPTION_WEATHER_INVALID_METAR</A></td></tr>
<tr><td><font color="gray">Specifies that the metar data supplied did not match the required format. See the section Metar Data Format for details on the format required.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "15">SIMCONNECT_EXCEPTION_WEATHER_UNABLE_TO_GET_OBSERVATION</A></td></tr>
<tr><td><font color="gray">Specifies that the weather observation requested was not available. Refer to the remarks section for SimConnect_WeatherRequestObservationAtStation for some notes on this exception.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "16">SIMCONNECT_EXCEPTION_WEATHER_UNABLE_TO_CREATE_STATION</A></td></tr>
<tr><td><font color="gray">Specifies that the weather station could not be created.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "17">SIMCONNECT_EXCEPTION_WEATHER_UNABLE_TO_REMOVE_STATION</A></td></tr>
<tr><td><font color="gray">Specifies that the weather station could not be removed.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<h4>AI errors</h4>

<table>
<tr><td><A NAME = "22">SIMCONNECT_EXCEPTION_CREATE_OBJECT_FAILED</A></td></tr>
<tr><td><font color="gray">Specifies that the attempt to create an AI object failed.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "23">SIMCONNECT_EXCEPTION_LOAD_FLIGHTPLAN_FAILED</A></td></tr>
<tr><td><font color="gray">Specifies that the specified flight plan could not be found, or did not load correctly.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "24">SIMCONNECT_EXCEPTION_OPERATION_INVALID_FOR_OBJECT_TYPE</A></td></tr>
<tr><td><font color="gray">Specifies that the operation requested does not apply to the object type, for example trying to set a flight plan on an object that is not an aircraft will result in this error.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "25">SIMCONNECT_EXCEPTION_ILLEGAL_OPERATION</A></td></tr>
<tr><td><font color="gray">Specifies that the AI operation requested cannot be completed, such as requesting that an object be removed when the client did not create that object. This error also applies to the Weather system.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "33">SIMCONNECT_EXCEPTION_OBJECT_OUTSIDE_REALITY_BUBBLE</A></td></tr>
<tr><td><font color="gray">Specifies that an attempt to create an ATC controlled AI object failed because the location of the object is outside the reality bubble.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "34">SIMCONNECT_EXCEPTION_OBJECT_CONTAINER</A></td></tr>
<tr><td><font color="gray">Specifies that an attempt to create an AI object failed because of an error with the container system for the object.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "35">SIMCONNECT_EXCEPTION_OBJECT_AI</A></td></tr>
<tr><td><font color="gray">Specifies that an attempt to create an AI object failed because of an error with the AI system for the object.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "36">SIMCONNECT_EXCEPTION_OBJECT_ATC</A></td></tr>
<tr><td><font color="gray">Specifies that an attempt to create an AI object failed because of an error with the ATC system for the object.</td>
</table>
<A HREF = "#top">Top</a><br><br>

<table>
<tr><td><A NAME = "37">SIMCONNECT_EXCEPTION_OBJECT_SCHEDULE</A></td></tr>
<tr><td><font color="gray">Specifies that an attempt to create an AI object failed because of a scheduling problem.</td>
</table>
<A HREF = "#top">Top</a><br><br>
 

Share this post


Link to post
Share on other sites
Help AVSIM continue to serve you!
Please donate today!

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now
Sign in to follow this