# AddInstallEx

### Description

Registers an installation with the server. You should call this function once when your application is installed. You should store the returned installID in your application's settings and reuse it on subsequent calls to the QlmAnalytics API.

Note that to call this function, you must initialize the QlmAnalytics object with the following properties:

* WebServiceUrl
* CommunicationEncryptionKey
* GUID (persistence key)

```csharp
bool AddInstallEx(string softwareVersion, string osVersion, 
                string computerName, string computerID, 
                string activationKey, string computerKey, 
                bool trial, string productName, 
                int majorVersion, int minorVersion, 
                string customData1, string customData2, string customData3,  
                ref string installID)
```

### Parameters

| Parameter       |  Type  | Description                               |
| --------------- | :----: | ----------------------------------------- |
| softwareVersion | string | version of your software                  |
| osVersion       | string | version of the operating system           |
| computerName    | string | name of the computer.                     |
| computerID      | string | unique computer identifier                |
| activationKey   | string | activation key on the system              |
| computerKey     | string | computer key associated with the system   |
| trial           |  bool  | flag indicating if the license is a trial |
| productName     | string | name of your product                      |
| majorVersion    |   int  | major version of your product             |
| minorVersion    |   int  | minor version of your product             |
| customData1     | string | your own custom data                      |
| customData2     | string | your own custom data                      |
| customData3     | string | your own custom data                      |
| installID       | string | retuned unique install identifier         |

### Return

| Type    | Description                                             |
| ------- | ------------------------------------------------------- |
| Boolean | true if the operation was successful; otherwise, false. |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.soraco.co/docs/api-reference/.net-api/iqlmanalytics/methods/addinstallex.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.