Here is an example:

    Dim WithEvents http As Chilkat.Http

    Private Sub http_OnPercentDone(ByVal sender As Object, ByVal args As Chilkat.PercentDoneEventArgs) Handles http.OnPercentDone
        ProgressBar1.Value = args.PercentDone
    End Sub

    Private Sub HttpDownloadTest()

        http = New Chilkat.Http()

        Dim success As Boolean

        '  Any string unlocks the component for the 1st 30-days.
        success = http.UnlockComponent("Anything for 30-day trial")
        If (success <> True) Then
            MsgBox(http.LastErrorText)
            Exit Sub
        End If

        ‘ Enable event callbacks…
        http.EnableEvents = True

        ‘  Download the Python language install.
        ‘  Note: This URL may have changed since this example was created.
        success = http.Download(”http://www.python.org/ftp/python/2.5/python-2.5.msi”, “python-2.5.msi”)
        If (success <> True) Then
            MsgBox(http.LastErrorText)
        Else
            MsgBox(”Python Download Complete!”)
        End If

        http = Nothing

    End Sub

Chilkat methods that return date/time information do so using SYSTEMTIME. The reason is that Chilkat’s C++ API uses SYSTEMTIME (a MS Windows struct for holding date/time information) and these are wrapped to produce the Java (JNI) API.

Here is an example showing how to access the contents of SYSTEMTIME:

    CkEmail email = new CkEmail();

    SYSTEMTIME dt = new SYSTEMTIME();
    email.get_LocalDate(dt);

	int month = dt.getWMonth();
	int year = dt.getWYear();
	int day = dt.getWDay();
	int hour = dt.getWHour();
	int minute = dt.getWMinute();
	int second = dt.getWSecond();

If you pass a filename with no path to the SFTP OpenFile method, and the SFTP server is WS_FTP, you may get a “Folder not found” error.

An SFTP server *should* open or create the file in the home directory of the logged-in account. This doesn’t seem to be the case with the WS_FTP server. The fix is to call RealPath(”.”,”") to get the absolute path of the logged-in account, and then combine this with the filename and pass it to OpenFile.

For example, if trying to OpenFile(”helloWorld.txt”)

and RealPath(”.”,”") returns “/chilkat”,

then do this: OpenFile(”/chilkat/helloWorld.txt”)

Recently, the ESET NOD32 AntiVirus program began erroneously detecting the Chilkat .NET 2.0/3.5 download as containing a Genetik Trojan virus. This is incorrect (i.e. it is a false positive). After researching the Genetik Trojan, it has become apparent that NOD32’s virus definition for this particular virus is frequently a false-positive. If you experience this problem, report the false-positive by sending email to samples@eset.com.

NOTE: The problem only occurs during the download. The ChilkatDotNet2.dll, once on your system, is not detected as a virus. Therefore, you may bypass the problem by downloading the Chilkat .NET assembly from this encrypted .zip:

http://www.chilkatsoft.com/download/ChilkatDotNet2_enc.zip
The password is “chilkatsoft”.

Unzip and place the ChilkatDotNet2.dll in your app’s bin directory. In Visual Studio, add a reference to this assembly by browsing to the DLL’s location and selecting the DLL.

Question:

"When using Chilkat .NET from an SSIS script, make sure the
ChilkatDotNet2.dll assembly is stored in the GAC (Global Assembly
Cache). This is required to allow the .NET runtime to find and load
the assembly."

However, when I try to add a reference to ChilkatDotNet2.dll it does
not show up on the list of available dll's. Do you have any experience
with this problem? Any way you can help me get over this hurdle?

Answer:

Inside of SSIS there is no tab to browse. The interface is a little
simpler than the one for traditional .Net apps.

FYI...

I just discovered this. I also had to add the DLL to the .NET Framework
folder: C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727

Now it shows up on the list!

Crypt2

• Added “UU” and “Base32″ to the encoding and decoding capabilities.  Any method ending in “ENC” may now encode to/from UU and Base32.   The encoding is controlled by the EncodingMode property, which allows for these new encodings, as well as all of the existing ones — Hex, Base64, Quoted-Printable, URL, etc.
• Added EncodeString and DecodeString methods.
• Added UuMode and UuFilename properties for UU encoding.

HTTP

• Added SOCKS4/SOCKS5 support.
• Added support for Digest Authentication.

Email

• The default boundary string generated for Email / MIME changed to be the same style as used by Mozilla Thunderbird.  The word “Chilkat” is no longer used within the boundary string.  This is part of a number of changes intended to make email / MIME produced by Chilkat as generic as possible.
• The X-Mailer header field is no longer automatically added to new emails.
• The auto-generated Message-ID header field is now formatted similar to this:  8ED6C040290CC34B8DC638B43AE6D40F053D7B0A@myhostname
  It is a string of hex digits followed by ‘@’, followed by the local hostname/domain of the computer where the application is running.  Previously, the Message-ID was a UID-like string containing the keyword “Chilkat” ending with “@myhostname”.  The new format is more generic and has the same style as that produced by Mozilla Thunderbird.
• Email.LoadEml now handles binary MIME with embedded NULLs
• MIME continuation lines will use SPACE instead of TAB for 1st char in continuation.
• Tries to avoid folding lines unnecessarily if total header field length is 78 chars or less.

FTP2

• If the server does not recognize the extended passive command (EPSV), the FTP2 component/lib will automatically re-try with the PASV command.
• Fixed directory parsing problem for old Mac FTP directory listings.
• FTP2 SendBufferSize property now defaults to 512K for improved performance.
• FTP2 automatically skips “lost+found” directory when downloading directory tree.

IMAP

• StartTls property added. Default is false/0.
• SslProtocol property added.  Default is “TLS 1.0″

MIME

• Added a new DKIM component/class for creating and verifying DKIM-Signature and DomainKey-Signature MIME headers.
• Very rare MIME crash bug fixed.
• MIME continuation lines will use SPACE instead of TAB for 1st char in continuation.
• Tries to avoid folding lines unnecessarily if total header field length is 78 chars or less.

MHT

• HTTP responses that include the Set-Cookie header are now cached (if caching is enabled via the UpdateCache property).   (Note: The HTTP component does not cache responses that include the Set-Cookie header.)

RSA

• Added new methods: SignHash, SignHashENC, VerifyHash, VerifyHashENC.

Socket

• HeartbeatMs default property value changed from 1000ms to 0 (no AbortCheck event).

SSH / SFTP

• (SFTP) ResumeUploadFileByName — if the remote file does not exist, it simply uploads the entire file (instead of failing on attempt to get remote file size).
• (SFTP) Now handles “filename-charset” extensions sent by SFTP server.
• (SFTP) Added the FilenameCharset property to allow an application to explicitly indicate the charset of filenames returned by the SFTP server.
• (SSH) RSA Key fingerprint calculation fixed.
• Connection problem with Mocana SSH server fixed (SSH-2.0-Mocana SSH)
• UploadFileByName/DownloadFileByName fixed for SFTP v4 servers.

TAR

• Added support for POSIX, GNU, and USTAR formats.
• Added the ability to create TAR archives in any of the above formats.
• Added the ability to create compressed TAR archives in the above formats using Bzip2, Z, or Gzip — i.e. extensions such as .tar.tgz, .tar.bz2, .tar.Z, .tar.gz, etc..

Zip

• (self-extractor) Added the ability to delete extracted files after the setup.exe within the self-extractor runs.  To create a self-extracting EXE that automatically deletes files, call zipObject.SetExeConfigParam(”Cleanup”,”1″)
• Bug fixed with WinZip compatible AES encryption for 0-length files.
• Fixed: Zip component incorrectly indicated that password (for Zip 2.0 legacy encryption) was invalid for some .zips (this was rare).

C++

• Added wchar_t * Unicode C++ classes.  For any Chilkat C++ classes that have methods returning a const char * or with const char * arguments, you will now find a class of the same name ending in “W” with wchar_t * type declarations.  For example, the CkEmailW class is the wchar_t * version of the CkEmail class.  It is found in CkEmailW.h  The wide-char classes derive from the non-wide-char class.  Wide-char methods are named the same as non-wide-char methods, but with a “W” appended to the method name.  For example, CkEmail contains the method
  bool setFromMimeText(const char *mimeText),
  whereas CkEmailW contains
  bool setFromMimeTextW(const wchar_t *mimeText)
• Removed last dependency on wininet.lib.  (The only code within Chilkat that depends on Microsoft’s wininet.lib is the freeware FTP component/lib.)

Java

• Added build for Windows 64-bit OS (x64).

Perl

• Added build for Windows 64-bit OS (x64), for both Perl 5.8 and Perl 5.10.

Python

• Added build for Windows 64-bit OS (x64) for Python 2.6.

General Improvements

• Internally, 8bit Western-European chars are interpreted according to Windows-1252 by default instead of iso-8859-1.  These charsets are virtually identical, except that byte values in the range of 0×80-0×9F are defined by Windows-1252 whereas in iso-8859-1 no chars are represented by these values.  This helps in rare cases where chars in this range are “dropped”.  Note: This fixes problems that are very rarely seen.
• VerboseLogging property added to many classes/components to provide more detailed logging when diagnosing problems.
• Added the TcpNoDelay property to SSH, SshTunnel, and Socket components to enable/disable Nagle algorithm.  This improves performance for cases where many small messages are sent back and forth.
  Note from user: “I must admit that I was skeptical whether turning Nagle off would make a difference, since theoretically Nagle only deals with how long to wait before sending a packet when the prior one was unanswered, and in the protocol I was testing, the application was enforcing the wait for an application-level response to packet N before sending packet N+1. (And the packets were small enough that there was no likelihood of them being split.) But indeed, the new version is definitely faster than the previous one, and in fact is slightly faster than my previous tunneling implementation, so I would call that a success.”
• For DNS lookups, internal caching is implemented to avoid creating a background thread for duplicate DNS lookups.  This improvement applies to many components wherever a DNS lookup is required.
• HeartbeatMs property default changed to 0 for SshTunnel, SocksProxy, HttpProxy, Upload.
• Fixed SOCKS5 w/ no authentication.  This applies to all components supporting SOCKS5 proxies.

This error can happen when trying to transfer a file or list a directory in Active (PORT) mode. The problem is usually solved by switching to Passive mode. Set the Ftp2.Passive property equal to True.

Explanation of the problem: In Active mode, the data connection is setup like this: The client sends a PORT command telling the server the port where it will be listening for the data connection. The server receives the PORT command and initiates a connection to the client’s IP/port. However, if a firewall is blocking the incoming connection, then it will go unanswered, and the server will timeout waiting for the connection to be accepted.

This error message is usually an indication that the VC++ runtime is missing on a system.

Downloading and installing the Microsoft VC++ runtime that matches the version you need will fix this problem.  To find the redistributable at microsoft.com, Google using this search string “visual c++ redistributable 2005″.  Substitute “2008″, “2002″, or “2003″ for different versions…

For example, one recent Chilkat customer had this error message in Java:

java.lang.UnsatisfiedLinkError: C:\temp\new\chilkat.dll: This
application has failed to start because the application
configuration is incorrect. Reinstalling the application may fix this problem

The Chilkat modules/libs for Java, Perl, Python, and Ruby are compiled using Visual C++ 2005 (not SP1), so you would need the runtime for that version (i.e. VC++ 8.0).

This note applies to the instantiation of ActiveX components (not .NET assemblies).

If a call to CreateObject (VBScript) or Server.CreateObject (ASP) or sp_OACreate (SQL) fails with the following errors:

Invalid class string

Invalid ProgID

It indicates that the ActiveX has not been registered via regsvr32 on the computer, or the registry permissions on the ProgID key prevent the object from being created.

To register, open a MS-DOS command prompt and type:

c:\> regsvr32 c:\path\ChilkatSomething.dll

Where “ChilkatSomething.dll” is the filename of a Chilkat ActiveX DLL.

The DLL may be located in any directory.  (It does not need to be placed in Windows\system32.)  The important point is that once registered, the DLL’s physical location should not be changed.

This error might also be the result of insufficient permissions for the ProgID registry key.  If you know the component has been registered via regsvr32, run regedt32 and check the permissions on the HKEY_CLASSES_ROOT\ProgID, where ProgID is a string such as “Chilkat.Ftp2″ or “Chilkat.Ssh”.  The full set of ProgID’s may be found here:  Chilkat ProgID’s for CreateObject Open the registry key, select Permissions from the Edit menu and grant the “Everyone” account full control.

I found this PDF somewhere on Microsoft’s site, but now I cannot find it anymore.  Therefore, I uploaded it to here:  http://www.cknotes.com/microsoft-certificate-support.pdf

This contains a collection of how-to procedures for certificates:

• Install certificate after deleting the pending certificate request (IIS 6.0)
• Installing Server Certificates (IIS 6.0)
• How to install a certificate for use with IP Security in Windows Server 2003
• Key Archival and Management in Windows Server 2003
• Renew a certificate with the same key
• Renew a certificate with a new key
• How To Renew or Create New Certificate Signing Request While Another Certificate Is Currently Installed
• Request a certificate using a PKCS #10 or PKCS #7 file
• Renew a root certification authority
• Importing and exporting certificates
• Trusted root certification authority policy
• Object IDs Associated with Microsoft Cryptography
• Certutil tasks for backing up and restoring certificates