Instance Registration and Activation

In order for a Linxter enabled program instance to be able to create communication channels, and send and receive messages, it must first be Registered and Activated.

Instance Registration

When an instance of your program is first run, it will need to register itself to the ISB using the RegisterProgramInstance() method. During the registration process, it receives its own unqiue Program Instance ID, as well as pull down its configuration settings — these are the Program settings you entered in Web Manager when registering your program to the ISB.

IsRegistered Property

The IsRegistered property gets a value indicating whether the registration of the program instance has been completed. You should use this property in your code to verify registration.

Instance Activation

Instances need to be activated in order to know who gets to administer them. When an instance is activated, it has been associated with its administrator’s Linxter Web Manager account. When registering your program to the ISB via Web Manager, you chose whether you want instances of your program to be activated manually or automatically. This was reviewed previously.

IsActivated Property

The IsActivated property gets a value indicating if the program instance has been activated. You should use this property in your code to verify activation.

ProgramInstanceActivated Event

The ProgramInstanceActivated event is triggered when the program instance is activated. This event is primarily used if in Web Manager when you registered your program to the ISB you chose to have your instances manually activated.

Note: If in Web Manager you have your instances set to be automatically activated, activation occurrs as part of the instance registration step.