# SimConnect_CameraAcquire<no value>
The **SimConnect\_CameraAcquire** function is used to acquire the add-on camera. Note that the camera may not be immediately useable on acquisition, as it may be under simulation control. Please see the main [Camera API](camera-api/) page for more information.

 

##### Syntax

``` cpp
HRESULT SimConnect_CameraAcquire(
    HANDLE  hSimConnect
    );
```

 

##### Parameters

{{< table-wrapper >}}

| Parameter     | Description                    | Type    |
|---------------|--------------------------------|---------|
| `hSimConnect` | Handle to a SimConnect object. | 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. If the camera failed to be acquired, SimConnect will raise a `SIMCONNECT_EXCEPTION_CAMERA_API` exception to let you know that the operation failed (refer to the `SIMCONNECT_EXCEPTION` enum for more details). |

{{< /table-wrapper >}}


 

##### Example

``` cpp
HANDLE  hSimConnect = NULL;
SimConnect_CameraAcquire(hSimConnect)
```

 

##### Remarks

The sim will send a [SIMCONNECT\_RECV\_CAMERA\_STATUS](../structures-and-enumerations/simconnect-recv-camera-status/) to the client at the end of acquisition which you can use to check the camera has been properly acquired. It's handled through [SimConnect\_CallDispatch](../general/simconnect-calldispatch/).