| Development licensing |
Deployment licensing |
| Engine Developer Kit |
Engine Runtime |
|
|
ArcView |
|
|
ArcEditor |
|
|
ArcInfo |
In this topic
About using the LicenseControl
The LicenseControl initializes an application with a suitable license or licenses so it can run successfully on any machines it is deployed to. The LicenseControl configures licenses at application start time when the form or dialog box containing the LicenseControl is loaded. Use the LicenseControl to automatically perform license initialization in simple GUI (graphical user interface) applications using the
MapControl,
PageLayoutControl,
GlobeControl,
SceneControl,
TOCControl,
ToolbarControl, or
SymbologyControl.
If greater control is required over license initialization, particularly when checking out and checking in extension licenses (the LicenseControl checks out extension licenses for the duration of an application's life), use the
AoInitialize object in the
System library to programmatically perform license initialization.
The LicenseControl is visible in a visual design environment, but is invisible at runtime, therefore unlike the other controls, the LicenseControl does not provide any user interface in an application. In design time, the LicenseControl property pages must be used to configure the application with product and extension licenses. The LicenseControl is only available with the COM (Component Object Manager) ActiveX Control and .NET Windows Control APIs (application programming interfaces).
Properties dialog box descriptions
The following describes each area on the Properties dialog box:
-
Products—Select at least one product license the application can be initialized with. By default, the LicenseControl tries to initialize the application with the ArcGIS Engine product license. If the product you require is not licensed, you may optionally initialize the application with a higher product license. For example, if you select the ArcGIS Engine license and the ArcView license, the LicenseControl initially tries to initialize the application with an ArcGIS Engine license (the lower level license). If that license is not available, the LicenseControl tries to initialize the application with an ArcView license (the next higher level license selected). If no product licenses are available, the application will fail to initialize. Once an application is initialized with a product license it is not possible to reinitialize the application for the duration of the application's life.
-
Extensions—Select the extension licenses required by the application. Not every extension license is available with every product license, as such the list of available extension licenses will change as different product licenses become selected. If the ArcGIS Engine product license is selected and an ArcGIS Desktop product is selected, only the ArcGIS Engine extension licenses display. The availability of each extension license is checked in conjunction with the product license that the application will ultimately be initialized with. If any of the selected extensions are not available, the application fails to initialize. The LicenseControl checks out extensions directly after the application is initialized and checks in extensions when the application is shutdown.
If a GlobeControl or SceneControl (requiring the 3D Analyst extension) is embedded in the same container as the LicenseControl, the 3D Analyst extension is automatically checked.
-
Shutdown—Set whether the LicenseControl automatically shuts down the application if license initialization fails. If the LicenseControl handles license initialization failure, a License Failure dialog box appears to the end user before the application is shutdown. If the developer handles license initialization failure, the ILicenseControl interface members can be used to obtain information on the nature of the failure before the application is programmatically shut down.
See Also:
Controls library overview
