Unicode C

SSH Tunnel for Database Connection (such as ADO, ODBC, JDBC, etc.)

See more SSH Tunnel Examples

Demonstrates how to create an SSH tunneling client in a background thread of your application. This makes it possible to SSH tunnel database connections without the need for separate software (such as PuTTY) to be running. Unicode C

#include <C_CkSshTunnelW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkSshTunnelW tunnel;
    const wchar_t *sshHostname;
    int sshPort;
    int listenPort;
    BOOL waitForThreadExit;

    success = FALSE;

    //  This example assumes the Chilkat API to have been previously unlocked.
    //  See Global Unlock Sample for sample code.

    success = FALSE;

    tunnel = CkSshTunnelW_Create();

    sshHostname = L"sftp.example.com";
    sshPort = 22;

    //  Connect to an SSH server and establish the SSH tunnel:
    success = CkSshTunnelW_Connect(tunnel,sshHostname,sshPort);
    if (success != TRUE) {
        wprintf(L"%s\n",CkSshTunnelW_lastErrorText(tunnel));
        CkSshTunnelW_Dispose(tunnel);
        return;
    }

    //  Authenticate with the SSH server via a login/password
    //  or with a public key.  
    //  This example demonstrates SSH password authentication.
    success = CkSshTunnelW_AuthenticatePw(tunnel,L"mySshLogin",L"mySshPassword");
    if (success != TRUE) {
        wprintf(L"%s\n",CkSshTunnelW_lastErrorText(tunnel));
        CkSshTunnelW_Dispose(tunnel);
        return;
    }

    //  The destination host/port is the database server.
    //  The DestHostname may be the domain name or 
    //  IP address (in dotted decimal notation) of the database
    //  server.
    CkSshTunnelW_putDestPort(tunnel,1433);
    CkSshTunnelW_putDestHostname(tunnel,L"myDbServer.com");

    //  Start accepting connections in a background thread.
    //  The SSH tunnels are autonomously run in a background
    //  thread.  There is one background thread for accepting
    //  connections, and another for managing the tunnel pool.
    listenPort = 3316;
    success = CkSshTunnelW_BeginAccepting(tunnel,listenPort);
    if (success != TRUE) {
        wprintf(L"%s\n",CkSshTunnelW_lastErrorText(tunnel));
        CkSshTunnelW_Dispose(tunnel);
        return;
    }

    //  At this point the app may connect to the database server through
    //  the SSH tunnel.  The database connection string would
    //  use "localhost" for the hostname and 3316 for the port.
    //  We're not going to show the database coding here,
    //  because it can vary depending on the API you're using
    //  (ADO, ODBC, OLE DB, etc. )

    //  This is where the application's database code would go...

    //  Stop the background listen/accept thread:
    waitForThreadExit = TRUE;
    success = CkSshTunnelW_StopAccepting(tunnel,waitForThreadExit);
    if (success != TRUE) {
        wprintf(L"%s\n",CkSshTunnelW_lastErrorText(tunnel));
        CkSshTunnelW_Dispose(tunnel);
        return;
    }

    //  Close the SSH tunnel (would also kick any remaining connected clients).
    success = CkSshTunnelW_CloseTunnel(tunnel,waitForThreadExit);
    if (success != TRUE) {
        wprintf(L"%s\n",CkSshTunnelW_lastErrorText(tunnel));
        CkSshTunnelW_Dispose(tunnel);
        return;
    }



    CkSshTunnelW_Dispose(tunnel);

    }