C# Signature:

[DllImport("winscard.dll")]
static extern int SCardEstablishContext(uint dwScope, IntPtr pvReserved1, IntPtr pvReserved2, out IntPtr phContext);
static extern int SCardEstablishContext(int dwScope,IntPtr pvReserved1, IntPtr pvReserved2, out int phContext);

VB Signature:

<DllImport("winscard.dll")> _
Public Shared Function SCardEstablishContext(dwScope as UInteger, pvReserved1 as IntPtr,  pvReserved2 as IntPtr, <out>() phContext as IntPtr) As Integer
End Function
<DllImport("winscard.dll", SetLastError:=True, _
            CharSet:=CharSet.Unicode, ExactSpelling:=True, _
            CallingConvention:=CallingConvention.StdCall)> _
    Public Shared Function SCardEstablishContext(dwScope as Integer, pvReserved1 as IntPtr,  pvReserved2 as IntPtr, <out>() phContext as Integer) As Integer
    End Function

User-Defined Types:

None.

Notes:

See the sample for other signatures.

The given signature will likely fail under a 64-bit OS with an error 6. A signature that works on 64-bit and 32-bit is:

in winscard.h

#define SCARD_SCOPE_USER     0    // The context is a user context, and any
                // database operations are performed within the
                // domain of the user.
#define SCARD_SCOPE_TERMINAL 1    // The context is that of the current terminal,
                // and any database operations are performed
                // within the domain of that terminal.  (The
                // calling application must have appropriate
                // access permissions for any database actions.)
#define SCARD_SCOPE_SYSTEM   2    // The context is the system context, and any
                // database operations are performed within the
                // domain of the system.  (The calling
                // application must have appropriate access
                // permissions for any database actions.)

Tips & Tricks:

Please add some!

Sample Code:

This static class contains a single method to detect whether a smartcard is inserted in any reader. Tested under 32- and 64-bit Vista.

    static class SmartCard
    {

    #region Win32
    // WinSCard APIs to be imported.
    [DllImport("WinScard.dll")]
    static extern int SCardEstablishContext(uint dwScope,
    IntPtr notUsed1,
    IntPtr notUsed2,
    out IntPtr phContext);

    [DllImport("WinScard.dll")]
    static extern int SCardReleaseContext(IntPtr phContext);

The same holds true for many other smartcard methods, where the context should be an IntPtr. See the sample for other signatures.

    [DllImport("WinScard.dll")]
    static extern int SCardConnect(IntPtr hContext,
    string cReaderName,
    uint dwShareMode,
    uint dwPrefProtocol,
    ref IntPtr phCard,
    ref IntPtr ActiveProtocol);

in winscard.h

#define SCARD_SCOPE_USER 0 // The context is a user context, and any

                // database operations are performed within the
                // domain of the user.

#define SCARD_SCOPE_TERMINAL 1 // The context is that of the current terminal,

                // and any database operations are performed
                // within the domain of that terminal.  (The
                // calling application must have appropriate
                // access permissions for any database actions.)

#define SCARD_SCOPE_SYSTEM 2 // The context is the system context, and any

                // database operations are performed within the
                // domain of the system.  (The calling
                // application must have appropriate access
                // permissions for any database actions.)

    [DllImport("WinScard.dll")]
    static extern int SCardDisconnect(IntPtr hCard, int Disposition);

    // [DllImport("WinScard.dll")]
    // static extern int SCardListReaderGroups(IntPtr hContext,
    // ref string cGroups,
    // ref int nStringSize);

Tips & Tricks:

Please add some!

    [DllImport("WinScard.dll", EntryPoint = "SCardListReadersA", CharSet = CharSet.Ansi)]
    static extern int SCardListReaders(
      IntPtr hContext,
      byte[] mszGroups,
      byte[] mszReaders,
      ref UInt32 pcchReaders
      );

Sample Code:

    // [DllImport("WinScard.dll")]
    // static extern int SCardFreeMemory(IntPtr hContext,
    // string cResourceToFree);

This static class contains a single method to detect whether a smartcard is inserted in any reader. Tested under 32- and 64-bit Vista.

    #endregion
    static class SmartCard
    {

    #region Win32
    // WinSCard APIs to be imported.
    [DllImport("WinScard.dll")]
    static extern int SCardEstablishContext(uint dwScope,
    IntPtr notUsed1,
    IntPtr notUsed2,
    out IntPtr phContext);

    internal static bool SmartCardInserted()
    {
        bool cardInserted = false;
        IntPtr hContext = IntPtr.Zero;
    [DllImport("WinScard.dll")]
    static extern int SCardReleaseContext(IntPtr phContext);

        try
        {
    [DllImport("WinScard.dll")]
    static extern int SCardConnect(IntPtr hContext,
    string cReaderName,
    uint dwShareMode,
    uint dwPrefProtocol,
    ref IntPtr phCard,
    ref IntPtr ActiveProtocol);

        List<string> readersList = new List<string>();
    [DllImport("WinScard.dll")]
    static extern int SCardDisconnect(IntPtr hCard, int Disposition);

        int ret = 0;
        uint pcchReaders = 0;
        int nullindex = -1;
        char nullchar = (char)0;
    // [DllImport("WinScard.dll")]
    // static extern int SCardListReaderGroups(IntPtr hContext,
    // ref string cGroups,
    // ref int nStringSize);

        // Establish context.
        ret = SCardEstablishContext(2, IntPtr.Zero, IntPtr.Zero, out hContext);
    [DllImport("WinScard.dll", EntryPoint = "SCardListReadersA", CharSet = CharSet.Ansi)]
    static extern int SCardListReaders(
      IntPtr hContext,
      byte[] mszGroups,
      byte[] mszReaders,
      ref UInt32 pcchReaders
      );

        // First call with 3rd parameter set to null gets readers buffer length.
        ret = SCardListReaders(hContext, null, null, ref pcchReaders);
    // [DllImport("WinScard.dll")]
    // static extern int SCardFreeMemory(IntPtr hContext,
    // string cResourceToFree);

        byte[] mszReaders = new byte[pcchReaders];

    #endregion

        // Fill readers buffer with second call.
        ret = SCardListReaders(hContext, null, mszReaders, ref pcchReaders);

        // Populate List with readers.
        ASCIIEncoding ascii = new ASCIIEncoding();
    internal static bool SmartCardInserted()
    {
        bool cardInserted = false;
        IntPtr hContext = IntPtr.Zero;

        string currbuff = ascii.GetString(mszReaders);
        try
        {

        int len = (int)pcchReaders;
        List<string> readersList = new List<string>();

        if (len > 0)
        {
            while (currbuff[0] != nullchar)
            {
            nullindex = currbuff.IndexOf(nullchar);   // Get null end character.
            string reader = currbuff.Substring(0, nullindex);
            readersList.Add(reader);
            len = len - (reader.Length + 1);
            currbuff = currbuff.Substring(nullindex + 1, len);
            }
        }
        int ret = 0;
        uint pcchReaders = 0;
        int nullindex = -1;
        char nullchar = (char)0;

        // We have list of readers, check for cards.
        IntPtr phCard = IntPtr.Zero;
        IntPtr ActiveProtocol = IntPtr.Zero;
        int result = 0;
        // Establish context.
        ret = SCardEstablishContext(2, IntPtr.Zero, IntPtr.Zero, out hContext);

        foreach (string readerName in readersList)
        // First call with 3rd parameter set to null gets readers buffer length.
        ret = SCardListReaders(hContext, null, null, ref pcchReaders);

        byte[] mszReaders = new byte[pcchReaders];

        // Fill readers buffer with second call.
        ret = SCardListReaders(hContext, null, mszReaders, ref pcchReaders);

        // Populate List with readers.
        ASCIIEncoding ascii = new ASCIIEncoding();

        string currbuff = ascii.GetString(mszReaders);

        int len = (int)pcchReaders;

        if (len > 0)
        {
            try
            while (currbuff[0] != nullchar)
            {
            result = SCardConnect(hContext, readerName, 2, 3, ref phCard, ref ActiveProtocol);
            if (result == 0)
            {
                cardInserted = true;
                break;
            }
            nullindex = currbuff.IndexOf(nullchar);   // Get null end character.
            string reader = currbuff.Substring(0, nullindex);
            readersList.Add(reader);
            len = len - (reader.Length + 1);
            currbuff = currbuff.Substring(nullindex + 1, len);
            }
            finally
            {
            SCardDisconnect(phCard, 0);
            }
        }
        }
        finally
        {
        SCardReleaseContext(hContext);
        }

        return cardInserted;
        // We have list of readers, check for cards.
        IntPtr phCard = IntPtr.Zero;
        IntPtr ActiveProtocol = IntPtr.Zero;
        int result = 0;

    }
    }
        foreach (string readerName in readersList)
        {
            try
            {
            result = SCardConnect(hContext, readerName, 2, 3, ref phCard, ref ActiveProtocol);
            if (result == 0)
            {
                cardInserted = true;
                break;
            }
            }
            finally
            {
            SCardDisconnect(phCard, 0);
            }
        }
        }
        finally
        {
        SCardReleaseContext(hContext);
        }

        return cardInserted;

    }
    }

Alternative Managed API:

TODO

Alternative Managed API:

TODO

Please edit this page!

Do you have...

• helpful tips or sample code to share for using this API in managed code?
• corrections to the existing content?
• variations of the signature you want to share?
• additional languages you want to include?

Select "Edit This Page" on the right hand toolbar and edit it! Or add new pages containing supporting types needed for this API (structures, delegates, and more).