Desktop Functions:

   Smart Device Functions:

Show Recent Changes
Subscribe (RSS)
Misc. Pages
Helpful Tools
Suggested Reading
Website TODO List
Support Forum
Download Visual Studio Add-In

Terms of Use
Privacy Policy
SCardListReaders (winscard)
The SCardListReaders function provides the list of readers within a set of named reader groups, eliminating duplicates.

C# Signature:

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

VB.NET Signature:

    <DllImport("WinScard.dll", EntryPoint:="SCardListReadersA", CharSet:=CharSet.Ansi)>
    Public Shared Function SCardListReaders(
      hContext As IntPtr,
      mszGroups As Byte(),
      mszReaders As Byte(),
      ByRef pcchReaders As UInt32
      ) As Integer
    End Function

User-Defined Types:




Tips & Tricks:

if you invoke SCardListReaders with the hContext parameter set to null, you'll get the list of the installed readers (not the plugged ones !)

Sample Code:

long ret = 0;
int hContext;
Int32 pcchReaders = 0;
int nullindex = -1;
char nullchar = (char) 0;
ArrayList readersList = new ArrayList();

//establish context
ret = SCardEstablishContext(SCARD_SCOPE_USER,IntPtr.Zero,IntPtr.Zero,out hContext);

//get readers buffer len
ret = SCardListReaders(hContext,IntPtr.Zero,null,ref pcchReaders);
byte[] mszReaders = new byte[pcchReaders];

// fill readers' buffer
ret = SCardListReaders(hContext,IntPtr.Zero ,mszReaders, ref pcchReaders);

//fill readersList
//remember that readers is a multistring with a double trailing \0
// This is much easier and faster to do the allocation like this than the looping way
//ASCIIEncoding asc = new ASCIIEncoding();
//String[] Readers = asc.GetString( mszReaders ).Split( '\0' );
ASCIIEncoding ascii = new ASCIIEncoding();
string currbuff = ascii.GetString(mszReaders);
int len = pcchReaders;

while (currbuff[0]!=nullchar)
  nullindex = currbuff.IndexOf(nullchar);   //get null end character
  string reader = currbuff.Substring(0, nullindex);
  len = len-(reader.Length+1);
  currbuff = currbuff.Substring(nullindex+1,len);            

ret = SCardReleaseContext(hContext);

Alternative Managed API:



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

Access directly from VS:
Terms of Use
Edit This Page
Find References
Show Printable Version