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);

    }