ArcGIS Engine Developer Guide

APPLICATION DEVELOPMENT AND LICENSE INITIALIZATION
Step 1: Check product license
availability
Step 2: Check extension license
availability
Step 3: Initialize the application
The checkout of licenses may fail even though
the availability check was successful. This is
particularly possible in cases where Desktop
Concurrent licenses were initially available but
may have since been checked out by another
application.
Step 4: Check extensions in and
out
Step 5: Shutdown
Step 1: Check product license
availability
Step 2: Check extension license
availability
Step 3: Initialize the application
The checkout of licenses may fail even though
the availability check earlier in the process was
successful. This is particularly possible in cases in
which Desktop Concurrent licenses—instead of
Single Use ones—were initially available but
may have since been checked out by another
application.
Step 4: Check extensions in and
out
Attempting initialization with the ArcEditor product license
In this example, a secondary level of licensing is available if the first ArcGIS
Engine product level fails to initialize correctly. The application once again attempts
to initialize by following the defined process.
1. Check whether an ArcEditor 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 tertiary level of allowable product licensing.
2. Check whether an ArcGIS Spatial Analyst extension license is available with
the ArcEditor product license. If yes, proceed to the next step in the initialization
process. If not, discontinue this attempt and restart initialization with
any tertiary level of allowable product licensing.
3. Check out the ArcEditor 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 initializationwith
any tertiary level of allowable product licensing.
4. Check out the ArcGIS Spatial Analyst extension. Since no other extension
licenses are needed, if the license checked out, the application has been successfully
configured with licenses.
If the license failed to check out, discontinue this attempt and restart initialization
with any tertiary level of allowable product licensing.
5. The final step in the initialization process is ensuring that the licenses are
released when the application is shut down.
Attempting initialization with the ArcInfo product license
In this example, if both the first (ArcGIS Engine) and second (ArcEditor) product
levels fail to initialize correctly, a third level of licensing is available, ArcInfo.
The application makes a final attempt to initialize by following the defined
process.
1. Check whether an ArcInfo product license is available. If yes, proceed to the
next step in the initialization process. If not, discontinue this final attempt.
The application cannot run successfully at this time.
2. Check whether an ArcGIS Spatial Analyst extension license is available with
the ArcInfo product license. If yes, proceed to the next step in the initialization
process. If not, discontinue this final attempt. The application cannot run
successfully at this time.
3. Check out the ArcInfo product license by initializing the application. If the
license failed to check out, discontinue this final attempt. The application
cannot run successfully at this time.
4. Check out the ArcGIS Spatial Analyst extension. Since no other extension
licenses are needed, if the licenses are checked out, the application has been
successfully configured with licenses. If the license failed to check out,
discontinue this final attempt. The application cannot run successfully at this
time.
Chapter 5 • Licensing and deployment • 269