ArcGIS Engine Developer Guide

APPLICATION DEVELOPMENT AND LICENSE INITIALIZATION
Step 5: Shutdown
5. The final step in the initialization process is ensuring that the licenses are
released when the application is shut down.
EXAMPLE C—MINIMUM LICENSE IS ARCGIS ENGINE. OPTIONAL
NETWORK FUNCTIONALITY AVAILABLE
Once again the example application requires a minimum of an ArcGIS Engine
license. The developer has decided that if an ArcGIS Engine license is not available,
the application could run with an ArcView, ArcEditor, or ArcInfo license
instead. Similar to the previous examples, this application also includes extension
functionality—Network—but, in this case, the extension is not required simply
to run the application; instead, it enables additional functionality. As such the
Network extension will be checked out dynamically during the use of the application
rather than at application startup.
Once again the application will first attempt to initialize against the ArcGIS
Engine product license. If that fails, it will make additional attempts to initialize
against an ArcView license, an ArcEditor license, and if still unsuccessful, the
application will finally attempt to initialize against the ArcInfo product license.
The following sections outline the steps taken to initialize the application with a
license.
Step 1: Check product license
availability
Step 2: Check extension license
availability
Step 3: Initialize the application
Step 4: Check extensions in and
out
Step 5: Shutdown
Attempting initialization with the ArcGIS Engine product license
As indicated above, to run successfully the application requires at minimum an
ArcGIS Engine product license. While Network functionality is available within
the application, its extension license can be checked out when needed rather than
for the duration of the session. The application’s first attempt at initialization
should be against this minimal level of product licensing. The application’s attempts
at initialization follow the process discussed earlier.
1. Check whether an ArcGIS Engine product license is available. If yes, proceed
to the next step in the initialization process. If not, discontinue this attempt
and restart initialization with any secondary level of allowable product licensing.
2. Check whether a Network extension license is available with the ArcGIS
Engine product license. If yes, proceed to the next step in the initialization
process. If not, proceed to the next step in the initialization process.
3. Check out the ArcGIS Engine product license by initializing the application.
If the license checked out, proceed to the next step in the initialization process.
If the license failed to check out, discontinue this attempt and restart
initialization with any secondary level of allowable product licensing.
Since this application dynamically checks out the Network extension, this step
is not performed at this time. Instead, the license will be checked out during
usage of Network functionality. See the section ‘Using Network functionality’
below for details on this process.
In this example, no licenses beyond the ArcGIS Engine product license need
to be checked out, so if that license checked out, the application has been
successfully configured with licenses.
4. The final step in the initialization process is ensuring that the licenses are
released when the application is shut down.
270 • ArcGIS Engine Developer Guide