ArcGIS Engine Developer Guide

BUILDING A COMMAND-LINE C++ APPLICATION
}
AoExit(0);
return 0;
AoExit(0);
return 0;
}
3. Write helper functions that initialize and shut down the engine. These are
general functions that you can use in any command-line application.
a. In RasterSlope.h:
#include
bool InitializeWithExtension(esriLicenseProductCode product,
esriLicenseExtensionCode extension);
void ShutdownApp(esriLicenseExtensionCode license);
b. At the bottom of RasterSlope.cpp:
bool InitializeWithExtension(esriLicenseProductCode product,
esriLicenseExtensionCode extension)
{
::AoInitialize(0);
IAoInitializePtr ipInit(CLSID_AoInitialize);
esriLicenseStatus licenseStatus = esriLicenseFailure;
ipInit->IsExtensionCodeAvailable(product, extension, &licenseStatus);
if (licenseStatus == esriLicenseAvailable)
{
ipInit->Initialize(product, &licenseStatus);
if (licenseStatus == esriLicenseCheckedOut)
ipInit->CheckOutExtension(extension, &licenseStatus);
}
return (licenseStatus == esriLicenseCheckedOut);
}
It appears that a new instance of AoInitialize is
created in ShutdownApp(). However, it is a
singleton object and so returns a pointer to the
AoInitialize object that was previously created.
void ShutdownApp(esriLicenseExtensionCode license)
{
// Scope ipInit so released before AoUninitialize call
{
IAoInitializePtr ipInit(CLSID_AoInitialize);
esriLicenseStatus status;
ipInit->CheckInExtension(license, &status);
ipInit->Shutdown();
}
}
::AoUninitialize();
Command-line applications can be run against any ArcGIS Engine installation—
Runtime or developer kit—or any installation of the ArcGIS Desktop products
(ArcView, ArcEditor, or ArcInfo). However, this particular application requires a
Spatial license in addition to the core license. Depending on the core product
Chapter 6 • Developer scenarios • 435