# ArResolveCloudAnchorFuture

An asynchronous operation for resolving a Cloud Anchor launched by `https://developers.google.com/ar/reference/c/group/ar-session#arsession_resolvecloudanchorasync`.

See the [Cloud Anchors developer guide](https://developers.google.com/ar/develop/c/cloud-anchors/developer-guide) for more information.

## Summary

| ### Typedefs ||
|---|---|
| `https://developers.google.com/ar/reference/c/group/ar-resolve-cloud-anchor-future#arresolvecloudanchorcallback)(void *context, ArAnchor *anchor, ArCloudAnchorState cloud_anchor_state)` | typedef `void(*` Callback definition for `https://developers.google.com/ar/reference/c/group/ar-session#arsession_resolvecloudanchorasync`. |
| `https://developers.google.com/ar/reference/c/group/ar-resolve-cloud-anchor-future#arresolvecloudanchorfuture` | typedef `struct ArResolveCloudAnchorFuture_` Handle to an asynchronous operation launched by `https://developers.google.com/ar/reference/c/group/ar-session#arsession_resolvecloudanchorasync`. |

| ### Functions ||
|---|---|
| `https://developers.google.com/ar/reference/c/group/ar-resolve-cloud-anchor-future#arresolvecloudanchorfuture_acquireresultanchor(const https://developers.google.com/ar/reference/c/group/ar-session#arsession *session, const https://developers.google.com/ar/reference/c/group/ar-resolve-cloud-anchor-future#arresolvecloudanchorfuture *future, https://developers.google.com/ar/reference/c/group/ar-anchor#aranchor **out_anchor)` | `void` Gets the resolved Cloud Anchor. |
| `https://developers.google.com/ar/reference/c/group/ar-resolve-cloud-anchor-future#arresolvecloudanchorfuture_getresultcloudanchorstate(const https://developers.google.com/ar/reference/c/group/ar-session#arsession *session, const https://developers.google.com/ar/reference/c/group/ar-resolve-cloud-anchor-future#arresolvecloudanchorfuture *future, https://developers.google.com/ar/reference/c/group/ar-anchor#arcloudanchorstate *out_cloud_anchor_state)` | `void` Gets the result status of the resolving operation, if the operation is done. |

## Typedefs

### ArResolveCloudAnchorCallback

```
void(* ArResolveCloudAnchorCallback)(void *context, ArAnchor *anchor, ArCloudAnchorState cloud_anchor_state)
```
Callback definition for `https://developers.google.com/ar/reference/c/group/ar-session#arsession_resolvecloudanchorasync`.

The `context` argument will be the same as that passed to `https://developers.google.com/ar/reference/c/group/ar-session#arsession_resolvecloudanchorasync`. The `anchor` argument will be the same as that returned by `https://developers.google.com/ar/reference/c/group/ar-resolve-cloud-anchor-future#arresolvecloudanchorfuture_acquireresultanchor` and must be released using `https://developers.google.com/ar/reference/c/group/ar-anchor#aranchor_release`. The `cloud_anchor_state` argument will be the same as that returned by `https://developers.google.com/ar/reference/c/group/ar-resolve-cloud-anchor-future#arresolvecloudanchorfuture_getresultcloudanchorstate`.

It is a best practice to free `context` memory provided to `https://developers.google.com/ar/reference/c/group/ar-session#arsession_resolvecloudanchorasync` at the end of the callback implementation.

### ArResolveCloudAnchorFuture

```
struct ArResolveCloudAnchorFuture_ ArResolveCloudAnchorFuture
```
Handle to an asynchronous operation launched by `https://developers.google.com/ar/reference/c/group/ar-session#arsession_resolvecloudanchorasync`.

Release with `https://developers.google.com/ar/reference/c/group/ar-future#arfuture_release`. ([reference type, long-lived](https://developers.google.com/ar/reference/c/group/concepts#object-ownership)).

## Functions

### ArResolveCloudAnchorFuture_acquireResultAnchor

```
void ArResolveCloudAnchorFuture_acquireResultAnchor(
  const ArSession *session,
  const ArResolveCloudAnchorFuture *future,
  ArAnchor **out_anchor
)
```
Gets the resolved Cloud Anchor.

If the operation isn't done yet or the operation failed, this will be `NULL`. The caller must release the anchor using `https://developers.google.com/ar/reference/c/group/ar-anchor#aranchor_release`.


Details Parameters `session` The ARCore session. `future` The handle for the asynchronous operation. `out_anchor` The anchor.

### ArResolveCloudAnchorFuture_getResultCloudAnchorState

```
void ArResolveCloudAnchorFuture_getResultCloudAnchorState(
  const ArSession *session,
  const ArResolveCloudAnchorFuture *future,
  ArCloudAnchorState *out_cloud_anchor_state
)
```
Gets the result status of the resolving operation, if the operation is done.


Details Parameters `session` The ARCore session. `future` The handle for the asynchronous operation. `out_cloud_anchor_state` The result status.