# SimConnect_SubscribeToFacilities_EX1<no value>
The **SimConnect\_SubscribeToFacilities\_EX1** function is used to request notifications when a facility of a certain type is added to the facilities cache, with the ability to specify callbacks.

 

##### Syntax

``` cpp
HRESULT SimConnect_SubscribeToFacilities_EX1(
    HANDLE hSimConnect,
    SIMCONNECT_FACILITY_LIST_TYPE type,
    SIMCONNECT_DATA_REQUEST_ID newElemInRangeRequestID,
    SIMCONNECT_DATA_REQUEST_ID oldElemOutRangeRequestID
    );
```

 

##### Parameters

<table><thead><tr class="header"><th>Parameter</th><th>Description</th><th>Type</th></tr></thead><tbody><tr class="odd"><td><code>hSimConnect</code></td><td>Handle to a SimConnect object.</td><td>Integer</td></tr><tr class="even"><td><code>type</code></td><td>Specifies one member of the <a href="../Structures_And_Enumerations/SIMCONNECT_FACILITY_LIST_TYPE.htm"><code>SIMCONNECT_FACILITY_LIST_TYPE</code></a> enumeration type.</td><td>Enum</td></tr><tr class="odd"><td><code>newElemInRangeRequestID</code></td><td><p>Request Id for messages about new elements considered to be in range of the reality bubble. If -1 is used, then the client won't receive messages for elements coming into range.</p><p><strong>NOTE</strong>: This cannot be set to -1 if <code>oldElemOutRangeRequestID</code> is also -1.</p></td><td>Integer</td></tr><tr class="even"><td><code>oldElemOutRangeRequestID</code></td><td><p>Request Id for messages about an element that is newly considered out of range of the reality bubble. If -1 is used, then the client won't receive messages for elements coming into range.</p><p><strong>NOTE</strong>: This cannot be set to -1 if <code>newElemInRangeRequestID</code> is also -1.</p></td><td>Integer</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

This function is a version of the [`SimConnect_SubscribeToFacilities`](simconnect-subscribetofacilities/) and works in almost the exact same way with one exception. Using `SIMCONNECT_FACILITY_LIST_TYPE_AIRPORT` will now return a list of the airports within the current reality bubble, *not* the entire world. You can also specify the callbacks to use when a facility either enters or leaves the reality bubble. Note that to unsubscribe you should use the companion function [`SimConnect_UnsubscribeToFacilities_EX1`](simconnect-unsubscribetofacilities-ex1/).

 

##### See Also

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