ArcGIS Engine Developer Guide

C++ APPLICATION PROGRAMMING INTERFACE
If it is in the correct location and you are using either Solaris or Linux, the next
thing to try is running arcgis/init_engine.sh (or .csh). The message may mean that
$ARCENGINEHOME/include isn’t in the compiler’s include path. In the
samples, our makefiles typically take care of adding this for you. However, if
$ARCENGINEHOME isn’t set, it will fail, and it is set in the arcgis/init_engine
script.
Error: Please define either ESRI_WINDOWS or ESRI_UNIX
You need to inform the compiler of which set of header files to use. On Windows,
you need to define the ESRI_WINDOWS symbol. On Solaris and Linux,
you need to define the ESRI_UNIX symbol. If you are using a makefile (either
with nmake on Windows or make on Solaris or Linux), you will set this with the
“D” compiler flag. In Visual Studio 6.0, you set it on the C/C++ tab of the
Project Menu > Settings dialog box by selecting “Preprocessor” from the Category
combo box and adding “ESRI_WINDOWS” to the “Preprocessor Definitions”
textbox. In Visual Studio .NET 2003, the symbol is defined in the Project
Menu > Properties dialog box in the C/C++ folder by clicking Preprocessor and
adding “ESRI_WINDOWS” to the Preprocessor Definitions textbox.
Windows-specific errors
• Cannot open type library file esriSystem.olb
This Windows error means that your sample is not compiling because it cannot
open an ESRI OLB file. Make sure that you have the correct argument for the
COM include directory, which is ArcGIS\Com in a default installation. If it is
correct and it is still not working, make sure the file is in that directory.
• Code is compiling but will not run. Sometimes I get an odd “abnormal
program termination” error.
On Windows, if samples or your own code compiles but fails to run, make
sure you registered your ArcGIS Engine. Run the SoftwareAuthorization tool
found in Start > All Programs > ArcGIS and follow its prompts.
Solaris- and Linux-specific errors
• Error: No valid runtime license was found.
This means that you have not registered your ArcGIS Engine. Run the
SoftwareAuthorization tool found in arcgis/authorizeSoftware and follow its
prompts.
• fatal: libarcsdk.so: open failed: No such file or directory (Solaris)
OR
/usr/bin/ld: cannot find -larcsdk (Linux)
This tells you that $ARCENGINEHOME/bin isn’t in the
LD_LIBRARY_PATH, which is set up when you run the arcgis/init_engine.sh
(or .csh) script. Run the init_engine script.
Chapter 4 • Developer environments • 233