ArcFM Desktop Developer Guide
MMAppInitialize Interface
Miner.Interop.System Assembly > Miner.Interop Namespace : MMAppInitialize Interface
Members 


Version: 10.2.1b and 10.2.1b SP1

Resource Center Home
This class initializes ArcFM components in the runtime environment. This class must be the first ArcFM object created. Use this class when ArcFM licensed code is running or designated to run outside the context of ArcMap or ArcCatalog (e.g., Responder Data Services, ArcFM Viewer for ArcGIS Engine, Trace All Feeders). ArcGIS for Server Users: The runtime mode must be set to Server when initializing ArcFM Solution products.
Available at Version
9.2.1 and later
Product Availability
ArcFM Desktop and ArcFM Engine
Required Licenses
ArcFM, Designer, ArcFM Viewer, ArcFM Engine, ArcFM Engine Editor, or ArcFM Viewer for ArcGIS Engine
.NET Assembly

Miner.Interop.System.dll

Object Model
MMAppInitialize Interface
Syntax
'Declaration
 
<GuidAttribute("66E4EC77-00F0-4501-BE2A-ACFCC8EDFFE1")>
<CoClassAttribute(Miner.Interop.MMAppInitializeClass)>
<ComImportAttribute()>
Public Interface MMAppInitialize 
   Inherits IMMAppInitialize 
'Usage
 
Dim instance As MMAppInitialize
[Guid("66E4EC77-00F0-4501-BE2A-ACFCC8EDFFE1")]
[CoClass(Miner.Interop.MMAppInitializeClass)]
[ComImport()]
public interface MMAppInitialize : IMMAppInitialize 
Remarks
Supported Platforms: Windows The MMAppInitialize object must be used by developers to initialize each application with a suitable license(s) in order for it to run successfully on any machine to which it is deployed. License configuration must be undertaken at application start time, before any ArcFM Objects are accessed. Failure to do so will result in application errors. All applications need to be configured with a license except when the application is not a standalone executable (e.g., if it's a .dll that will be incorporated into an application that will perform the license configuration). There are two types of license to consider when initializing an application if an it uses any of the ArcFM extensions: mmLicenseProductCodes and mmLicensedExtensionCodes. These licenses can be Engine or Desktop licenses. Initialization of an application with a license must be performed in the following order:
  1. Check the product license is available with the IMMAppInitialize::IsProductCodeAvailable method.
  2. Check extension licenses are available (if required) with the IMMAppInitialize::IsExtensionCodeAvailable method.
  3. Initialize the application with the product license.
  4. As required, check out and in the extension(s) by calling the IMMAppInitialize::CheckOutExtension and IMMAppInitialize::CheckInExtension methods.
  5. Shutdown the application.
Once an application has been initialized with a license it cannot be re-initialized (with a new license). An application is initialized with a license for the duration of its life. When initializing an application with a license the following must be considered: Using an ArcFM Viewer license on an ArcFM Engine application will give you access to all the functionality available to a standard Engine license. Likewise, using an ArcFM license on an ArcFM Engine application will give you access to all the functionality available to an Engine license with GeoDatabase Editing.
Requirements

Target Platforms: Windows XP SP3 (32-bit and 64-bit), Windows 7 (32-bit and 64-bit)

Not all Operating Systems are supported on all products. Visit the ArcFM Solution Supported Versions page for full details.

See Also

Reference

MMAppInitialize Members
Miner.Interop Namespace

This class initializes ArcFM components in the runtime environment. This class must be the first ArcFM object created. Use this class when ArcFM licensed code is running or designated to run outside the context of ArcMap or ArcCatalog (e.g., Responder Data Services, ArcFM Viewer for ArcGIS Engine, Trace All Feeders). ArcGIS for Server Users: The runtime mode must be set to Server when initializing ArcFM Solution products.
Object Model
MMAppInitialize Interface
Syntax
'Declaration
 
<GuidAttribute("66E4EC77-00F0-4501-BE2A-ACFCC8EDFFE1")>
<CoClassAttribute(Miner.Interop.MMAppInitializeClass)>
<ComImportAttribute()>
Public Interface MMAppInitialize 
   Inherits IMMAppInitialize 
'Usage
 
Dim instance As MMAppInitialize
[Guid("66E4EC77-00F0-4501-BE2A-ACFCC8EDFFE1")]
[CoClass(Miner.Interop.MMAppInitializeClass)]
[ComImport()]
public interface MMAppInitialize : IMMAppInitialize 
Remarks
Supported Platforms: Windows The MMAppInitialize object must be used by developers to initialize each application with a suitable license(s) in order for it to run successfully on any machine to which it is deployed. License configuration must be undertaken at application start time, before any ArcFM Objects are accessed. Failure to do so will result in application errors. All applications need to be configured with a license except when the application is not a standalone executable (e.g., if it's a .dll that will be incorporated into an application that will perform the license configuration). There are two types of license to consider when initializing an application if an it uses any of the ArcFM extensions: mmLicenseProductCodes and mmLicensedExtensionCodes. These licenses can be Engine or Desktop licenses. Initialization of an application with a license must be performed in the following order:
  1. Check the product license is available with the IMMAppInitialize::IsProductCodeAvailable method.
  2. Check extension licenses are available (if required) with the IMMAppInitialize::IsExtensionCodeAvailable method.
  3. Initialize the application with the product license.
  4. As required, check out and in the extension(s) by calling the IMMAppInitialize::CheckOutExtension and IMMAppInitialize::CheckInExtension methods.
  5. Shutdown the application.
Once an application has been initialized with a license it cannot be re-initialized (with a new license). An application is initialized with a license for the duration of its life. When initializing an application with a license the following must be considered: Using an ArcFM Viewer license on an ArcFM Engine application will give you access to all the functionality available to a standard Engine license. Likewise, using an ArcFM license on an ArcFM Engine application will give you access to all the functionality available to an Engine license with GeoDatabase Editing.
Inheritance Hierarchy

Miner.Interop.MMAppInitialize

Requirements

Target Platforms: Windows XP SP3 (32-bit and 64-bit), Windows 7 (32-bit and 64-bit)

Not all Operating Systems are supported on all products. Visit the ArcFM Solution Supported Versions page for full details.

See Also

Reference

MMAppInitialize Members
Miner.Interop Namespace

 

 

Send Comment