Unicode C

Upgrade a Plain TCP Connection to TLS

Demonstrates Socket.ConvertToSsl, which upgrades an already-connected plain TCP socket to TLS by performing a client-side TLS handshake over the existing connection.

Background. This supports STARTTLS-style upgrades, where a protocol begins in plaintext and switches to TLS at a defined point. Perform the protocol-specific negotiation first, then call ConvertToSsl.

Chilkat Unicode C Downloads

Download Chilkat for Unicode C

Unicode C

#include <C_CkSocketW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkSocketW socket;
    BOOL bTls;
    int maxWaitMs;

    success = FALSE;

    socket = CkSocketW_Create();

    //  Connect as plain TCP (no TLS yet).
    bTls = FALSE;
    maxWaitMs = 5000;
    success = CkSocketW_Connect(socket,L"example.com",5000,bTls,maxWaitMs);
    if (success == FALSE) {
        wprintf(L"%s\n",CkSocketW_lastErrorText(socket));
        CkSocketW_Dispose(socket);
        return;
    }

    //  At the point where the application protocol permits a STARTTLS-style upgrade, perform any required
    //  negotiation, then upgrade the existing connection to TLS with a client-side handshake.
    success = CkSocketW_ConvertToSsl(socket);
    if (success == FALSE) {
        wprintf(L"%s\n",CkSocketW_lastErrorText(socket));
        CkSocketW_Dispose(socket);
        return;
    }

    wprintf(L"Connection upgraded to TLS.\n");


    CkSocketW_Dispose(socket);

    }