[Question]: Is the local cache ready to use after return from esp_ble_gattc_cache_refresh()?

[kolban]

There is a new API call called esp_ble_gattc_cache_refresh() that builds a local (to the ESP32) cache of the handles provided by the BLE server to which the client is connected. It is my belief that interactions at the BLE level are all asynchronous. My question is:

"After the return from a call to esp_ble_gattc_cache_refresh(), should we now assume that the cache is ready for use?"

It could be that this is a "blocking" call and won't return until after the cache has been populated ... however it is also possible that this is an indication to refresh the cache that will be completed at some future time. Can we clarify that thought? If this is an asynchronous request, can we document that and gain knowledge of what the completion indicator would be?