(MFC) ScMinidriver - PIN Authentication for Smart Card or USB Token

See more ScMinidriver Examples

Demonstrates how to PIN authenticate with a connected smart card or USB token.

Note: This functionality was introduced in Chilkat v9.5.0.87.

Note: The ScMinidriver functionality is for Windows-only because ScMinidriver DLLs only exist on Windows. In the next version, Chilkat will be releasing a Pkcs11 class to support Linux, MacOSX, and possibly other operating systems.

Chilkat C/C++ Library Downloads MS Visual C/C++ Libs

See Also: Using MFC CString in Chilkat

#include <CkScMinidriver.h>

void ChilkatSample(void)
    {
    CkString strOut;

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

    CkScMinidriver scmd;

    // Reader names (smart card readers or USB tokens) can be discovered
    // via List Readers or Find Smart Cards
    const char *readerName = "Alcor Micro USB Smart Card Reader 0";
    bool success = scmd.AcquireContext(readerName);
    if (success == false) {
        strOut.append(scmd.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    // If we are successful, the name of the currently inserted smart card is available:
    const char *cardName = scmd.cardName();
    strOut.append("Card name: ");
    strOut.append(cardName);
    strOut.append("\r\n");

    // Perform regular PIN authentication with the smartcard.
    // If authentication is successful, then the ScMinidriver session is authenticated and
    // operations such as signing are permissible.

    // The pin ID can be "user", "admin", or a number "3" through "7" (passed as a string).
    // The possible pin ID's for a given smartcard are obtained via the GetCardProperties method.
    // See Get Smart Card Properties for sample code.
    // You should generally use the "user" pin ID.  You would only use the other pin ID's for very specific purposes.
    const char *pinId = "user";

    // Change this to the PIN for your smart card.
    const char *pin = "0000";

    int retval = scmd.PinAuthenticate(pinId,pin);

    // The return value is 0 for success.
    // If the retval is greater than 0, it is the number of attempts remaining before the PIN is blocked.
    // If the retval equals -1, then something else went wrong and you should consult the LastErrorText.
    if (retval < 0) {
        strOut.append(scmd.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    if (retval > 0) {
        strOut.append("PIN authentcation failed, ");
        strOut.appendInt(retval);
        strOut.append(" attempts remaining before the PIN is blocked.");
        strOut.append("\r\n");
    }
    else {
        strOut.append("PIN authentication successful. Your session is now authenticated and you may proceed with operations such as signing.");
        strOut.append("\r\n");
    }

    // ...
    // ...
    // ...

    // When finished with operations that required authentication, you may if you wish, deauthenticate the session.
    success = scmd.PinDeauthenticate(pinId);
    if (success == false) {
        strOut.append(scmd.lastErrorText());
        strOut.append("\r\n");
    }

    // Delete the context when finished with the card.
    success = scmd.DeleteContext();
    if (success == false) {
        strOut.append(scmd.lastErrorText());
        strOut.append("\r\n");
    }



    SetDlgItemText(IDC_EDIT1,strOut.getUnicode());

    }