Class AoInitializeClass

Namespace
ESRI.ArcGIS.esriSystem
Assembly
ESRI.Server.System.dll
[ClassInterface(ClassInterfaceType.None)]
[Guid("E01BE902-CC85-4B13-A828-02E789E0DDA9")]
public class AoInitializeClass : AoInitialize, IAoInitialize, ISupportErrorInfo, ILicenseInformation
Inheritance
AoInitializeClass
Implements
Inherited Members

Constructors

AoInitializeClass()

public AoInitializeClass()

Explicit Interface Implementations

CheckInExtension(esriLicenseExtensionCode)

Check in an extension.

virtual esriLicenseStatus CheckInExtension(esriLicenseExtensionCode extensionCode)

Parameters

extensionCode esriLicenseExtensionCode

Returns

esriLicenseStatus

CheckOutExtension(esriLicenseExtensionCode)

Check out an extension.

virtual esriLicenseStatus CheckOutExtension(esriLicenseExtensionCode extensionCode)

Parameters

extensionCode esriLicenseExtensionCode

Returns

esriLicenseStatus

Remarks

If an application using extension functionality is initialized with an Engine single use license (ArcGIS Engine or ArcGIS Engine with Enterprise GeoDatabase) the extension license may automatically get checked out. This is because Engine single use licenses are not reference counted. It is highly recommended that extension licenses are always explicitly checked out using the CheckOutExtension method to support deployment of the application in both an environment that uses an Engine single use license and an environment that uses a license server (desktop single use or desktop concurrent licenses).

The CheckOutExtension method will fail to check out the specified extension license if:

  • the extension is not licensed.
  • the license is unavailable because it is already being used. An extension may fail to check out because it may have been checked out by another application since the IsExtensionCodeAvailable method checked its availability. (Desktop Concurrent licenses only).
  • an unexpected license failure occurs due to system administration problems.
  • the license is already checked out. Use the IsExtensionCheckedOut method to determine this.

GetLicenseExtensionName(esriLicenseExtensionCode)

Retrieve the name license extension code.

virtual string GetLicenseExtensionName(esriLicenseExtensionCode extensionCode)

Parameters

extensionCode esriLicenseExtensionCode

Returns

string

GetLicenseProductName(esriLicenseProductCode)

Retrieve the name license product code.

virtual string GetLicenseProductName(esriLicenseProductCode ProductCode)

Parameters

ProductCode esriLicenseProductCode

Returns

string

GetProductExtensions(esriLicenseProductCode)

Enumerate the extensions supported the product.

virtual ILicenseInfoEnum GetProductExtensions(esriLicenseProductCode ProductCode)

Parameters

ProductCode esriLicenseProductCode

Returns

ILicenseInfoEnum

Initialize(esriLicenseProductCode)

This must be called before any other ArcObjects are created to initialize product Code. If called a second time during the life time of an executable with a new product code, it will return esriLicenseAlreadyInitialized.

virtual esriLicenseStatus Initialize(esriLicenseProductCode ProductCode)

Parameters

ProductCode esriLicenseProductCode

Returns

esriLicenseStatus

Remarks

The Initialize method will fail to check out the specified product license if:

  • the license is unavailable because it is already being used (Desktop Concurrent licenses only).
  • an unexpected license failure occurs due to system administration problems.
  • the license is already initialized. An application is initialized with a product license for the duration of it life. Use the InitializedProduct method to determine what license an application is initialized with.

Note that loading data into the MapControl or PageLayoutControl through the property pages will automatically initialize the application with a product license. To ensure that the application is initialized with the product license specified by the Initialize method load data into the MapControl and PageLayoutControl programmatically after license initialization.

InitializedProduct()

Retrieve's the product code at which the application has been initialized.

virtual esriLicenseProductCode InitializedProduct()

Returns

esriLicenseProductCode

InterfaceSupportsErrorInfo(ref Guid)

virtual void InterfaceSupportsErrorInfo(ref Guid riid)

Parameters

riid Guid

IsExtensionCheckedOut(esriLicenseExtensionCode)

Is the Extension checked out.

virtual bool IsExtensionCheckedOut(esriLicenseExtensionCode extensionCode)

Parameters

extensionCode esriLicenseExtensionCode

Returns

bool

IsExtensionCodeAvailable(esriLicenseProductCode, esriLicenseExtensionCode)

Check if the Product Code is available and then the Extension Code for that product.

virtual esriLicenseStatus IsExtensionCodeAvailable(esriLicenseProductCode ProductCode, esriLicenseExtensionCode extensionCode)

Parameters

ProductCode esriLicenseProductCode
extensionCode esriLicenseExtensionCode

Returns

esriLicenseStatus

IsProductCodeAvailable(esriLicenseProductCode)

Check if the Product Code is available.

virtual esriLicenseStatus IsProductCodeAvailable(esriLicenseProductCode ProductCode)

Parameters

ProductCode esriLicenseProductCode

Returns

esriLicenseStatus

Shutdown()

Shutdown method. This should be the last call to ArcObjects in an application.

virtual void Shutdown()