# SimConnect_RequestCameraWorldLocker<no value>
The **SimConnect\_RequestCameraWorldLocker** function is used to set a locker in the world to load the terrain, scenery and objects around it, but *only if you have acquired the camera first*. This is useful if you wish to move the camera far from the user aircraft where the world data may have been unloaded from memory.

{{< callout context="caution" title="IMPORTANT!" icon="outline/alert-triangle" >}}

World lockers are **performance heavy**, and as such should be used with care and **released as soon as possible**.

{{< /callout >}}

 

##### Syntax

``` cpp
HRESULT SimConnect_RequestCameraWorldLocker(
    HANDLE  hSimConnect,
    SIMCONNECT_DATA_XYZ lockerPosition,
    SIMCONNECT_POSITION_REFERENTIAL referential,
    DWORD objectId
    );
```

 

##### 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>lockerPosition</code></td><td>Coordinates of the locker, depending of the selected <code>referential</code></td><td><code>SIMCONNECT_DATA_XYZ</code></td></tr><tr class="odd"><td><code>referential</code></td><td><p>The reference used to define the <code>lockerPosition</code> value. One of the following:</p><ol><li><strong>SimObject</strong> - The position is an offset from the simobject position (expressed in meters).</li><li><strong>SimObject Datum</strong> - The position is an offset from the simobject <a href="../../../../content-configuration/modular-simobjects/aircraft/modular-aircraft-simobjects/#datum-reference-point">Datum Reference Point</a> (expressed in meters).</li><li><strong>Eyepoint</strong> - The position is an offset from the aircraft pilot eyepoint (expressed in meters).</li><li><strong>World</strong> - The position is expressed using latitude, longitude, and altitude.</li></ol></td><td><code>SIMCONNECT_POSITION_REFERENTIAL</code></td></tr><tr class="even"><td><code>objectId</code></td><td><p>Ignored if is <code>referential</code> set to World.</p><p>The object Id of the simobject that will be used to set position by SimObject, SimObject Datum and Eyepoint referential.</p><p>Set to 0 to focus user's aircraft. If the object Id is invalid, user's aircraft will be used instead.</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. If the camera locker failed to be setup, 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_DATA_XYZ LFPG_LLA{ 49.0083899664, 2.53844117956, 320 };
SimConnect_RequestCameraWorldLocker(hSimConnect, LFPG_LLA, SIMCONNECT_POSITION_REFERENTIAL_WORLD, 0);
```

 

##### Remarks

The sim will send a `SIMCONNECT_RECV_CAMERA_WORLD_LOCKER` 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`.