<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <title>pcsc-lite: winscard.h File Reference</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <link href="doxygen.css" rel="stylesheet" type="text/css"/> </head> <body> <!-- Generated by Doxygen 1.7.3 --> <div id="top"> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">pcsc-lite <span id="projectnumber">1.7.2</span></div> </td> </tr> </tbody> </table> </div> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="modules.html"><span>Modules</span></a></li> <li><a href="annotated.html"><span>Data Structures</span></a></li> <li class="current"><a href="files.html"><span>Files</span></a></li> <li><a href="dirs.html"><span>Directories</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="files.html"><span>File List</span></a></li> <li><a href="globals.html"><span>Globals</span></a></li> </ul> </div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="dir_7a4553ee0c3b13d0e595a5d1659110a6.html">src</a> </li> <li class="navelem"><a class="el" href="dir_8a9b44811c0d1b881450d901a25922be.html">PCSC</a> </li> </ul> </div> </div> <div class="header"> <div class="summary"> <a href="#define-members">Defines</a> | <a href="#func-members">Functions</a> </div> <div class="headertitle"> <h1>winscard.h File Reference</h1> </div> </div> <div class="contents"> <p>This handles smartcard reader communications. <a href="#_details">More...</a></p> <div class="textblock"><code>#include <<a class="el" href="pcsclite_8h_source.html">pcsclite.h</a>></code><br/> </div><div class="textblock"><div class="dynheader"> Include dependency graph for winscard.h:</div> <div class="dyncontent"> <div class="center"><img src="winscard_8h__incl.png" border="0" usemap="#winscard_8h" alt=""/></div> <map name="winscard_8h" id="winscard_8h"> <area shape="rect" id="node3" href="pcsclite_8h.html" title="This keeps a list of defines for pcsc-lite." alt="" coords="9,83,87,112"/><area shape="rect" id="node5" href="wintypes_8h.html" title="This keeps a list of Windows(R) types." alt="" coords="5,160,91,189"/></map> </div> </div> <p><a href="winscard_8h_source.html">Go to the source code of this file.</a></p> <table class="memberdecls"> <tr><td colspan="2"><h2><a name="func-members"></a> Functions</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top">PCSC_API LONG </td><td class="memItemRight" valign="bottom"><a class="el" href="group__API.html#gaa1b8970169fd4883a6dc4a8f43f19b67">SCardEstablishContext</a> (DWORD dwScope, LPCVOID pvReserved1, LPCVOID pvReserved2, LPSCARDCONTEXT phContext)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Creates an Application Context to the PC/SC Resource Manager. <a href="group__API.html#gaa1b8970169fd4883a6dc4a8f43f19b67"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">PCSC_API LONG </td><td class="memItemRight" valign="bottom"><a class="el" href="group__API.html#ga6aabcba7744c5c9419fdd6404f73a934">SCardReleaseContext</a> (<a class="el" href="pcsclite_8h.html#a22530ffaff18b5d3e32260a5f1ce4abd">SCARDCONTEXT</a> hContext)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Destroys a communication context to the PC/SC Resource Manager. <a href="group__API.html#ga6aabcba7744c5c9419fdd6404f73a934"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">PCSC_API LONG </td><td class="memItemRight" valign="bottom"><a class="el" href="group__API.html#ga722eb66bcc44d391f700ff9065cc080b">SCardIsValidContext</a> (<a class="el" href="pcsclite_8h.html#a22530ffaff18b5d3e32260a5f1ce4abd">SCARDCONTEXT</a> hContext)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Check if a <a class="el" href="pcsclite_8h.html#a22530ffaff18b5d3e32260a5f1ce4abd">SCARDCONTEXT</a> is valid. <a href="group__API.html#ga722eb66bcc44d391f700ff9065cc080b"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">PCSC_API LONG </td><td class="memItemRight" valign="bottom"><a class="el" href="group__API.html#ga4e515829752e0a8dbc4d630696a8d6a5">SCardConnect</a> (<a class="el" href="pcsclite_8h.html#a22530ffaff18b5d3e32260a5f1ce4abd">SCARDCONTEXT</a> hContext, LPCSTR szReader, DWORD dwShareMode, DWORD dwPreferredProtocols, LPSCARDHANDLE phCard, LPDWORD pdwActiveProtocol)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Establishes a connection to the reader specified in <code>*</code> szReader. <a href="group__API.html#ga4e515829752e0a8dbc4d630696a8d6a5"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">PCSC_API LONG </td><td class="memItemRight" valign="bottom"><a class="el" href="group__API.html#gad5d4393ca8c470112ad9468c44ed8940">SCardReconnect</a> (<a class="el" href="pcsclite_8h.html#af328aca3e11de737ecd771bcf1f75fb5">SCARDHANDLE</a> hCard, DWORD dwShareMode, DWORD dwPreferredProtocols, DWORD dwInitialization, LPDWORD pdwActiveProtocol)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Reestablishes a connection to a reader that was previously connected to using <a class="el" href="group__API.html#ga4e515829752e0a8dbc4d630696a8d6a5" title="Establishes a connection to the reader specified in * szReader.">SCardConnect()</a>. <a href="group__API.html#gad5d4393ca8c470112ad9468c44ed8940"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">PCSC_API LONG </td><td class="memItemRight" valign="bottom"><a class="el" href="group__API.html#ga4be198045c73ec0deb79e66c0ca1738a">SCardDisconnect</a> (<a class="el" href="pcsclite_8h.html#af328aca3e11de737ecd771bcf1f75fb5">SCARDHANDLE</a> hCard, DWORD dwDisposition)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Terminates a connection made through <a class="el" href="group__API.html#ga4e515829752e0a8dbc4d630696a8d6a5" title="Establishes a connection to the reader specified in * szReader.">SCardConnect()</a>. <a href="group__API.html#ga4be198045c73ec0deb79e66c0ca1738a"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">PCSC_API LONG </td><td class="memItemRight" valign="bottom"><a class="el" href="group__API.html#gaddb835dce01a0da1d6ca02d33ee7d861">SCardBeginTransaction</a> (<a class="el" href="pcsclite_8h.html#af328aca3e11de737ecd771bcf1f75fb5">SCARDHANDLE</a> hCard)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Establishes a temporary exclusive access mode for doing a serie of commands in a transaction. <a href="group__API.html#gaddb835dce01a0da1d6ca02d33ee7d861"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">PCSC_API LONG </td><td class="memItemRight" valign="bottom"><a class="el" href="group__API.html#gae8742473b404363e5c587f570d7e2f3b">SCardEndTransaction</a> (<a class="el" href="pcsclite_8h.html#af328aca3e11de737ecd771bcf1f75fb5">SCARDHANDLE</a> hCard, DWORD dwDisposition)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Ends a previously begun transaction. <a href="group__API.html#gae8742473b404363e5c587f570d7e2f3b"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">PCSC_API LONG </td><td class="memItemRight" valign="bottom"><a class="el" href="group__API.html#ga18f33eebb45d9e0d2a091ca7a0511d26">SCardStatus</a> (<a class="el" href="pcsclite_8h.html#af328aca3e11de737ecd771bcf1f75fb5">SCARDHANDLE</a> hCard, LPSTR mszReaderName, LPDWORD pcchReaderLen, LPDWORD pdwState, LPDWORD pdwProtocol, LPBYTE pbAtr, LPDWORD pcbAtrLen)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the current status of the reader connected to by <code>hCard</code>. <a href="group__API.html#ga18f33eebb45d9e0d2a091ca7a0511d26"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aba437f6265f2b1fc29f5eb1a2343cb2b"></a><!-- doxytag: member="winscard.h::SCardGetStatusChange" ref="aba437f6265f2b1fc29f5eb1a2343cb2b" args="(SCARDCONTEXT hContext, DWORD dwTimeout, LPSCARD_READERSTATE rgReaderStates, DWORD cReaders)" --> PCSC_API LONG </td><td class="memItemRight" valign="bottom"><b>SCardGetStatusChange</b> (<a class="el" href="pcsclite_8h.html#a22530ffaff18b5d3e32260a5f1ce4abd">SCARDCONTEXT</a> hContext, DWORD dwTimeout, <a class="el" href="structSCARD__READERSTATE.html">LPSCARD_READERSTATE</a> rgReaderStates, DWORD cReaders)</td></tr> <tr><td class="memItemLeft" align="right" valign="top">PCSC_API LONG </td><td class="memItemRight" valign="bottom"><a class="el" href="group__API.html#gac3454d4657110fd7f753b2d3d8f4e32f">SCardControl</a> (<a class="el" href="pcsclite_8h.html#af328aca3e11de737ecd771bcf1f75fb5">SCARDHANDLE</a> hCard, DWORD dwControlCode, LPCVOID pbSendBuffer, DWORD cbSendLength, LPVOID pbRecvBuffer, DWORD cbRecvLength, LPDWORD lpBytesReturned)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Sends a command directly to the IFD Handler (reader driver) to be processed by the reader. <a href="group__API.html#gac3454d4657110fd7f753b2d3d8f4e32f"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">PCSC_API LONG </td><td class="memItemRight" valign="bottom"><a class="el" href="group__API.html#ga9a2d77242a271310269065e64633ab99">SCardTransmit</a> (<a class="el" href="pcsclite_8h.html#af328aca3e11de737ecd771bcf1f75fb5">SCARDHANDLE</a> hCard, const <a class="el" href="structSCARD__IO__REQUEST.html">SCARD_IO_REQUEST</a> *pioSendPci, LPCBYTE pbSendBuffer, DWORD cbSendLength, <a class="el" href="structSCARD__IO__REQUEST.html">SCARD_IO_REQUEST</a> *pioRecvPci, LPBYTE pbRecvBuffer, LPDWORD pcbRecvLength)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Sends an APDU to the smart card contained in the reader connected to by <a class="el" href="group__API.html#ga4e515829752e0a8dbc4d630696a8d6a5" title="Establishes a connection to the reader specified in * szReader.">SCardConnect()</a>. <a href="group__API.html#ga9a2d77242a271310269065e64633ab99"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">PCSC_API LONG </td><td class="memItemRight" valign="bottom"><a class="el" href="group__API.html#ga9d970d086d5218e080d0079d63f9d496">SCardListReaderGroups</a> (<a class="el" href="pcsclite_8h.html#a22530ffaff18b5d3e32260a5f1ce4abd">SCARDCONTEXT</a> hContext, LPSTR mszGroups, LPDWORD pcchGroups)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns a list of currently available reader groups on the system. <a href="group__API.html#ga9d970d086d5218e080d0079d63f9d496"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">PCSC_API LONG </td><td class="memItemRight" valign="bottom"><a class="el" href="group__API.html#ga93b07815789b3cf2629d439ecf20f0d9">SCardListReaders</a> (<a class="el" href="pcsclite_8h.html#a22530ffaff18b5d3e32260a5f1ce4abd">SCARDCONTEXT</a> hContext, LPCSTR mszGroups, LPSTR mszReaders, LPDWORD pcchReaders)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">This function returns a list of currently available readers on the system. <a href="group__API.html#ga93b07815789b3cf2629d439ecf20f0d9"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">PCSC_API LONG </td><td class="memItemRight" valign="bottom"><a class="el" href="group__API.html#ga0522241e3180cb05dfd166e28930e961">SCardFreeMemory</a> (<a class="el" href="pcsclite_8h.html#a22530ffaff18b5d3e32260a5f1ce4abd">SCARDCONTEXT</a> hContext, LPCVOID pvMem)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Releases memory that has been returned from the resource manager using the <a class="el" href="pcsclite_8h.html#a67db0943aeb13f9f468eaae39b5ff1b0">SCARD_AUTOALLOCATE</a> length designator. <a href="group__API.html#ga0522241e3180cb05dfd166e28930e961"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">PCSC_API LONG </td><td class="memItemRight" valign="bottom"><a class="el" href="group__API.html#gaacbbc0c6d6c0cbbeb4f4debf6fbeeee6">SCardCancel</a> (<a class="el" href="pcsclite_8h.html#a22530ffaff18b5d3e32260a5f1ce4abd">SCARDCONTEXT</a> hContext)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">This function cancels all pending blocking requests on the <a class="el" href="group__API.html#ga33247d5d1257d59e55647c3bb717db24" title="Blocks execution until the current availability of the cards in a specific set of readers changes...">SCardGetStatusChange()</a> function. <a href="group__API.html#gaacbbc0c6d6c0cbbeb4f4debf6fbeeee6"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">PCSC_API LONG </td><td class="memItemRight" valign="bottom"><a class="el" href="group__API.html#gaacfec51917255b7a25b94c5104961602">SCardGetAttrib</a> (<a class="el" href="pcsclite_8h.html#af328aca3e11de737ecd771bcf1f75fb5">SCARDHANDLE</a> hCard, DWORD dwAttrId, LPBYTE pbAttr, LPDWORD pcbAttrLen)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Get an attribute from the IFD Handler (reader driver). <a href="group__API.html#gaacfec51917255b7a25b94c5104961602"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">PCSC_API LONG </td><td class="memItemRight" valign="bottom"><a class="el" href="group__API.html#ga060f0038a4ddfd5dd2b8fadf3c3a2e4f">SCardSetAttrib</a> (<a class="el" href="pcsclite_8h.html#af328aca3e11de737ecd771bcf1f75fb5">SCARDHANDLE</a> hCard, DWORD dwAttrId, LPCBYTE pbAttr, DWORD cbAttrLen)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Set an attribute of the IFD Handler. <a href="group__API.html#ga060f0038a4ddfd5dd2b8fadf3c3a2e4f"></a><br/></td></tr> </table> <hr/><a name="_details"></a><h2>Detailed Description</h2> <div class="textblock"><p>This handles smartcard reader communications. </p> <p>Definition in file <a class="el" href="winscard_8h_source.html">winscard.h</a>.</p> </div></div> <hr class="footer"/><address class="footer"><small>Generated on Thu Mar 31 2011 for pcsc-lite by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address> </body> </html>