18.04.2015 Views

ArcGIS Engine Developer Guide

ArcGIS Engine Developer Guide

ArcGIS Engine Developer Guide

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

APPLICATION DEVELOPMENT AND LICENSE INITIALIZATION<br />

Step 4: Check extensions in and<br />

out<br />

Step 5: Shutdown<br />

Step 1: Check product license<br />

availability<br />

Step 2: Check extension license<br />

availability<br />

Step 3: Initialize the application<br />

Step 4: Check extensions in and<br />

out<br />

Step 5: Shutdown<br />

In this example, no licenses beyond the <strong>ArcGIS</strong> <strong>Engine</strong> product license need<br />

to be checked out, so if that license checked out, the application has been<br />

successfully configured with licenses.<br />

4. The final step in the initialization process is ensuring that the licenses are<br />

released when the application is shut down.<br />

Attempting initialization with the ArcInfo product license<br />

If the first (<strong>ArcGIS</strong> <strong>Engine</strong>), second (ArcView), and third (ArcEditor) product<br />

levels fail to initialize correctly, one final level of licensing—ArcInfo—is available.<br />

The application makes a final attempt to initialize by following the defined<br />

process.<br />

1. Check whether an ArcInfo product license is available. If yes, proceed to the<br />

next step in the initialization process. If not, discontinue this attempt and<br />

restart initialization with any fourth level of allowable product licensing.<br />

2. Check whether an <strong>ArcGIS</strong> Network extension license is available with the<br />

ArcInfo product license. If yes, proceed to the next step in the initialization<br />

process. If not, discontinue this attempt and restart initialization with any<br />

fourth level of allowable product licensing.<br />

3. Check out the ArcInfo product license by initializing the application. If the<br />

license checked out, proceed to the next step in the initialization process. If<br />

the license failed to check out, discontinue this attempt and restart initialization<br />

with any fourth level of allowable product licensing.<br />

Since this application dynamically checks out the <strong>ArcGIS</strong> Network extension,<br />

this step is not performed at this time. Instead, the license will be checked out<br />

during usage of Network functionality. See the section ‘Using Network<br />

functionality’ below for details on this process.<br />

In this example, no licenses beyond the <strong>ArcGIS</strong> <strong>Engine</strong> product license need<br />

to be checked out, so if that license checked out, the application has been<br />

successfully configured with licenses.<br />

4. The final step in the initialization process is ensuring that the licenses are<br />

released when the application is shut down.<br />

Using Network functionality<br />

During each of the initialization attempts in this example, the checkout of the<br />

Network extension did not occur during application startup. Instead, the checkout<br />

occurs dynamically when the Network functions are accessed within the<br />

application. This means that the Network license continues to be available to<br />

other users when not in use by this application.<br />

As discussed earlier in the chapter, the extension license must be of the same<br />

product type as the base license. If the application initialized with an <strong>ArcGIS</strong><br />

<strong>Engine</strong> product license, then the Network functionality cannot be initialized<br />

unless an <strong>ArcGIS</strong> <strong>Engine</strong> extension license for Network is available. When the<br />

application user attempts to perform any Network functions, the application<br />

performs the following steps to activate the needed functions:<br />

272 • <strong>ArcGIS</strong> <strong>Engine</strong> <strong>Developer</strong> <strong>Guide</strong>

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!