# SimConnect_RequestFacilitiesList_EX1<no value>
The **SimConnect\_RequestFacilitesList** function is used to request a list of all the facilities of a given type currently held in the reality bubble facilities cache.

 

##### Syntax

``` cpp
HRESULT SimConnect_RequestFacilitesList_EX1(
    HANDLE  hSimConnect,
    SIMCONNECT_FACILITY_LIST_TYPE  type,
    SIMCONNECT_DATA_REQUEST_ID  RequestID
    );
```

 

##### Parameters

{{< table-wrapper >}}

| Parameter   | Description                                                                                                                                       | Type    |
|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------|---------|
| hSimConnect | Handle to a SimConnect object.                                                                                                                    | Integer |
| type        | Specifies one member of the [`SIMCONNECT_FACILITY_LIST_TYPE`](../structures-and-enumerations/simconnect-facility-list-type/) enumeration type. | Enum    |
| RequestID   | Specifies the client defined request ID. This will be returned along with the data.                                                               | Integer |

{{< /table-wrapper >}}


 

##### 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

The simulation keeps a facilities cache of all the airports, waypoints, {{< glossterm >}}ndb{{< /glossterm >}} and {{< glossterm >}}vor{{< /glossterm >}} stations within a certain radius of the user aircraft. This radius varies depending on where the aircraft is in the world, but is at least large enough to encompass the whole of the reality bubble for airports and waypoints, and can be over 200 miles for {{< glossterm >}}vor{{< /glossterm >}} and {{< glossterm >}}ndb{{< /glossterm >}} stations. As the user aircraft moves facilities will be added to, and removed from, the cache. However, in the interests pf performance, hysteresis is built into the system.

 

To receive event notifications when a facility is added, use the [`SimConnect_SubscribeToFacilities_EX1`](simconnect-subscribetofacilities-ex1/) function. When this function is first called, a full list from the cache will be sent, thereafter just the additions will be transmitted. No notification is given when a facility is removed from the cache. the Obviously to terminate these notifications use the [`SimConnect_UnsubscribeToFacilities`](simconnect-unsubscribetofacilities/) function.

 

When requesting types of facility information, one function call has to be made for each of the four types of data. The data will be returned in one of the four structures:

-   [`SIMCONNECT_RECV_AIRPORT_LIST`](../structures-and-enumerations/simconnect-recv-airport-list/), which will contain a list of [`SIMCONNECT_DATA_FACILITY_AIRPOR`](../structures-and-enumerations/simconnect-data-facility-airport/) structures. Note that if you require a list of all the airports in the *world*, then you should be using the [`SimConnect_RequestFacilitesList`](simconnect-requestfaciliteslist/) function.
-   [`SIMCONNECT_RECV_NDB_LIST`](../structures-and-enumerations/simconnect-recv-ndb-list/), which will contain a list of [`SIMCONNECT_DATA_FACILITY_NDB`](../structures-and-enumerations/simconnect-data-facility-ndb/) structures.
-   [`SIMCONNECT_RECV_VOR_LIST`](../structures-and-enumerations/simconnect-recv-vor-list/), which will contain a list of [`SIMCONNECT_DATA_FACILITY_VOR`](../structures-and-enumerations/simconnect-data-facility-vor/) structures.
-   [`SIMCONNECT_RECV_WAYPOINT_LIST`](../structures-and-enumerations/simconnect-recv-waypoint-list/), which will contain a list of [`SIMCONNECT_DATA_FACILITY_WAYPOINT`](../structures-and-enumerations/simconnect-data-facility-waypoint/) structures.

The four list structures inherit the data from the [`SIMCONNECT_RECV_FACILITIES_LIST`](../structures-and-enumerations/simconnect-recv-facilities-list/) structure. Given that the list of returned facilities could be large, it may be split across several packets, and each packet must be interpreted separately by the client.

 

##### See Also

-   [SimConnect API Reference](../../simconnect-api-reference/)
-   [SimConnect\_SubscribeToFacilities\_EX1](simconnect-subscribetofacilities-ex1/)
-   [SimConnect\_UnsubscribeToFacilities\_EX1](simconnect-unsubscribetofacilities-ex1/)