# fsVarsGetIVarId<no value>
The **fsVarsGetIVarId** function can be used to get an existing `IVar`.

 

##### Syntax

``` wasm
FsLVarId fsVarsGetIVarId(
    const char* name,
    const char* componentPath,
    FsObjectId target
);
```

 

##### Parameters

<table><thead><tr class="header"><th>Parameters</th><th>Description</th></tr></thead><tbody><tr class="odd"><td><code>name</code></td><td><p>The name of the variable.</p></td></tr><tr class="even"><td><code>componentPath</code></td><td><p>The path of the component. The path format is</p><ul><li><code>path:to:component</code></li></ul><p>or</p><ul><li><code>path:to:component@alias</code></li></ul><p>Note that the alias is not mandatory but is recommended for performance issue and to avoid conflicts.</p></td></tr><tr class="odd"><td><code>target</code></td><td><p>The ID of the object from which the variable is being retrieved.</p></td></tr></tbody></table>

 

##### Return Values

The function returns the ID associated with the given name. If the given name has *not* been registered, the function will return `FS_VAR_INVALID_ID`. If an error occurred, the function will return `FS_VAR_INVALID_ID`.

 

##### Remarks

`IVar` are local to an instrument, regardless of the component from which the variable is retrieved, and it will be the same ID on *all the components of the instrument*, from the root component to its last child.

 

##### Example

``` wasm
FsIVarId iVarId = fsVarsGetIVarId("TOTO", "LIGHTING");
```