Must-Know Information
Before Programming with Chilkat
This page provides some basic information that should be known before you begin programming with Chilkat's components.
C++ Memory Leaks?
Making sure there are NO memory leaks is extremely important to Chilkat. Please read this blog post regarding memory leaks.
Many programmers mistakenly think memory leaks exist when it is actually not the case.
Success/Failure Return Values
.NET and Visual C++ methods that
return status information will return true for success,
and false for failure.
ActiveX methods that return status
information will return 1 for success, and 0 for
failure.
If an method returns a reference to an object, a failure is indicated by returning a NULL reference.
Retrieving Error Information
When a method fails, extended
error information can be retrieved as XML, HTML, or plain-text.
The LastErrorHtml, LastErrorText, and LastErrorXml
properties contain this information. These properties should
be examined when a failure status is returned. The last error
information can also be saved to an XML formatted file by calling
SaveLastError. Note: the LastErrorHtml, LastErrorText, and LastErrorXml properties will contain information even in the case of success.
30-Day Trial
Chilkat's non-free components are unlocked at runtime by calling the UnlockComponent method once at the beginning of a program. Your permanent unlock code is valid for all future versions of the component. The full-versions of all Chilkat components and libraries are publicly available at http:/www.chilkatsoft.com/downloads.asp.
Fully-functional Chilkat components can be tested for 30-days by passing an arbitrary string to UnlockComponent. This causes the component to automatically begin a 30-day trial.
Exceptions
Chilkat component and library methods never raise exceptions. If a method fails, it returns a status (true/false or 1/0) and the last-error information is available in LastErrorText, LastErrorXml, LastErrorHtml, or via SaveLastError. A returned NULL object reference also indicates failure.
ActiveX Windows 95/98/Me/NT4 Compatibility
The Chilkat ActiveX components are available for the older Windows operating systems: Win95 through NT4. There is a separate download link for the NT4 compatible ActiveX components at http:/www.chilkatsoft.com/downloads.asp
|
