《ASCE1885的信息安全》のWindows下智能卡应用程序的开发(二)

1）SCardListReaders函数用来获取系统中在指定读卡器组集合中的读卡器名字列表（去掉重复的）。调用者提供一读卡器组列表，函数返回这些指定组里面的读卡器名字列表；无法标识的组名将被忽略。

LONG WINAPI SCardListReaders(

__in SCARDCONTEXT hContext, //由SCardEstablishContext()建立的资源管理器上下文，

//不能为NULL

__in_opt LPCTSTR mszGroups, //读卡器组名，为NULL时表示列出系统中所有读卡器

__out LPTSTR mszReaders, //系统中指定读卡器组中的读卡器的名字，这是一个多重字符串

//各个名字之间用‘/0’分隔，最后一个名字后面是两个连续的‘/0’

//当该参数为NULL时，函数在pcchReaders中返回实际所需长度

__inout LPDWORD pcchReaders //mszReaders的有效字符长度，包括所有的‘/0’。当该参数指定

//为SCARD_AUTOALLOCATE时，mszReaders将被转为指向字节指针的

//指针，用于接收包含多重字符串的内存块地址，该内存块必须使用函数

//SCardFreeMemory来释放

);

返回值：成功时是SCARD_S_SUCCESS；当指定组中没有读卡器时，返回SCARD_E_NO_READERS_AVAILABLE；否则返回其他智能卡错误码。

下面是该函数的实例代码：

LPTSTR pmszReaders = NULL;

LPTSTR pReader;

LONG lReturn, lReturn2;

DWORD cch = SCARD_AUTOALLOCATE;

// Retrieve the list the readers.

// hSC was set by a previous call to SCardEstablishContext.

lReturn = SCardListReaders(hSC,

NULL,

(LPTSTR)&pmszReaders,

&cch );

switch( lReturn )

{

case SCARD_E_NO_READERS_AVAILABLE:

printf("Reader is not in groups./n");

// Take appropriate action.

// ...

break;

case SCARD_S_SUCCESS:

// Do something with the multi string of readers.

// Output the values.

// A double-null terminates the list of values.

pReader = pmszReaders;

while ( '/0' != *pReader )

{

// Display the value.

printf("Reader: %S/n", pReader );

// Advance to the next value.

pReader = pReader + wcslen((wchar_t *)pReader) + 1;

}

// Free the memory.

lReturn2 = SCardFreeMemory( hSC,

pmszReaders );

if ( SCARD_S_SUCCESS != lReturn2 )

printf("Failed SCardFreeMemory/n");

break;

default:

printf("Failed SCardListReaders/n");

// Take appropriate action.

// ...

break;

}

2）SCardGetStatusChange函数阻塞程序的运行直到指定的智能卡的可用性发生改变。调用者以SCARD_READERSTAT数组的形式提供需要监控的读卡器列表，以及最长等待的时间（ms）。

LONG WINAPI SCardGetStatusChange(

__in SCARDCONTEXT hContext, //由SCardEstablishContext()建立的资源管理器上下文

__in DWORD dwTimeout, //最长等待的毫秒数，0表示函数立即返回；INFINITE表示一直等待

__inout LPSCARD_READERSTATE rgReaderStates, //SCARD_READERSTATE结构数组，指定监控的

//读卡器，同时用于接收返回结果。为了接收新的智能卡到来的通知，需要将

//SCARD_READERSTATE结构中的szReader参数设为////?PnP?//Notification，其他成员

//设为0；注意：该结构数组中的每个结构的所有成员必须初始化为0后再根据需要设置

//其他值，否则，函数将在包含远程读卡器的情况下返回失败

__in DWORD cReaders //rgReaderStates结构中的元素个数

);

返回值：成功时：SCARD_S_SUCCESS；失败时：智能卡错误码。

3）SCardLocateCards函数在参数rgReaderStates中指定的读卡器列表中查找由参数mszCards指定的智能卡，并立即返回结果：

LONG WINAPI SCardLocateCards(

__in SCARDCONTEXT hContext, //由SCardEstablishContext()建立的资源管理器上下文

__in LPCTSTR mszCards, //包含要查找的智能卡的多重字符串

__inout LPSCARD_READERSTATE rgReaderStates, //SCARD_READERSTATE结构数组，作为输入参数

//时，指定在其中查找的读卡器列表；作为输出参数时，接收查找结果

__in DWORD cReaders //rgReaderStates结构中元素个数

);

返回值：成功时：SCARD_S_SUCCESS；失败时：智能卡错误码。

该函数和SCardGetStatusChange函数一起使用时特别有用，当调用SCardLocateCards函数找不到匹配的智能卡时，应用程序可以使用SCardGetStatusChange函数来等待智能卡可用性的改变。

实例代码如下：

// Copyright (c) Microsoft Corporation. All rights reserved.

#include <stdio.h>

#include <winscard.h>

#include <tchar.h>

#pragma comment(lib, "winscard.lib")

HRESULT __cdecl main()

{

HRESULT hr = S_OK;

LPTSTR szReaders, szRdr;

DWORD cchReaders = SCARD_AUTOALLOCATE;

DWORD dwI, dwRdrCount;

SCARD_READERSTATE rgscState[MAXIMUM_SMARTCARD_READERS];

TCHAR szCard[MAX_PATH];

SCARDCONTEXT hSC;

LONG lReturn;

// Establish the card to watch for.

// Multiple cards can be looked for, but

// this sample looks for only one card.

_tcscat_s ( szCard, MAX_PATH * sizeof(TCHAR), TEXT("GemSAFE"));

szCard[lstrlen(szCard) + 1] = 0; // Double trailing zero.

// Establish a context.

lReturn = SCardEstablishContext(SCARD_SCOPE_USER,

NULL,

NULL,

&hSC );

if ( SCARD_S_SUCCESS != lReturn )

{

printf("Failed SCardEstablishContext/n");

exit(1);

}

// Determine which readers are available.

lReturn = SCardListReaders(hSC,

NULL,

(LPTSTR)&szReaders,

&cchReaders );

if ( SCARD_S_SUCCESS != lReturn )

{

printf("Failed SCardListReaders/n");

exit(1);

}

// Place the readers into the state array.

szRdr = szReaders;

for ( dwI = 0; dwI < MAXIMUM_SMARTCARD_READERS; dwI++ )

{

if ( 0 == *szRdr )

break;

rgscState[dwI].szReader = szRdr;

rgscState[dwI].dwCurrentState = SCARD_STATE_UNAWARE;

szRdr += lstrlen(szRdr) + 1;

}

dwRdrCount = dwI;

// If any readers are available, proceed.

if ( 0 != dwRdrCount )

{

for (;;)

{

// Look for the card.

lReturn = SCardLocateCards(hSC,

szCard,

rgscState,

dwRdrCount );

if ( SCARD_S_SUCCESS != lReturn )

{

printf("Failed SCardLocateCards/n");

exit(1);

}

// Look through the array of readers.

for ( dwI=0; dwI < dwRdrCount; dwI++)

{

if ( 0 != ( SCARD_STATE_ATRMATCH &

rgscState[dwI].dwEventState))

{

_tprintf( TEXT("Card '%s' found in reader '%s'./n"),

szCard,

rgscState[dwI].szReader );

SCardFreeMemory( hSC,

szReaders );

return 0; // Context will be release automatically.

}

// Update the state.

rgscState[dwI].dwCurrentState = rgscState[dwI].dwEventState;

}

// Card not found yet; wait until there is a change.

lReturn = SCardGetStatusChange(hSC,

INFINITE, // infinite wait

rgscState,

dwRdrCount );

if ( SCARD_S_SUCCESS != lReturn )

{

printf("Failed SCardGetStatusChange/n");

exit(1);

}

} // for (;;)

}

else

printf("No readers available/n");

// Release the context.

lReturn = SCardReleaseContext(hSC);

if ( SCARD_S_SUCCESS != lReturn )

{

printf("Failed SCardReleaseContext/n");

exit(1);

}

SCardFreeMemory( hSC,

szReaders );

return hr;

}

4）SCARD_READERSTATE结构用于智能卡跟踪函数中，定义如下：

typedef struct {

LPCTSTR szReader; //要监控的读卡器名字的指针，将该参数设为////?PnP?//Notification，其他参数均

//设为0，可用于通知新的读卡器的到来

LPVOID pvUserData; //智能卡子系统不使用该参数，该参数被应用程序使用

DWORD dwCurrentState; //被应用程序感知的读卡器当前的状态

DWORD dwEventState; //被智能卡资源管理器感知的读卡器当前状态

DWORD cbAtr; //返回的ATR的字节个数

BYTE rgbAtr[36]; //插入的智能卡的ATR（包含额外对齐的字节）

} SCARD_READERSTATE, *PSCARD_READERSTATE, *LPSCARD_READERSTATE;

参数dwCurrentState取值组合如下：

SCARD_STATE_UNAWARE---应用程序对当前状态一无所知，但想知道；使用该参数，状态转移监视服

务将立即返回；

SCARD_STATE_IGNORE---应用程序对这个读卡器不感兴趣，在监控期间不考虑该读卡器，设置该参数将

忽略其他位掩码；

SCARD_STATE_UNAVAILABLE---应用程序希望该读卡器当前不可用，设置该参数将忽略其他后续位掩码

SCARD_STATE_EMPTY---应用程序希望读卡器中没有智能卡，设置该参数将忽略其他后续位掩码；

SCARD_STATE_PRESENT---应用程序希望读卡器中有一个智能卡；

SCARD_STATE_ATRMATCH---应用程序希望读卡器中有一个匹配目标智能卡的智能卡

SCARD_STATE_EXCLUSIVE---应用程序希望读卡器中的智能卡不被共享

SCARD_STATE_INUSE---应用程序希望读卡器中的智能卡正被一个或多个应用程序使用，但使用共享连接

SCARD_STATE_MUTE---应用程序希望读卡器中有一个不响应的智能卡

参数dwEventState取值组合如下：

SCARD_STATE_IGNORE---该读卡器应该被忽略；

SCARD_STATE_CHANGED---该位被设置时，应用程序假设读卡器发生了明显的状态改变；

SCARD_STATE_UNKNOWN---给定的读卡器名字不被资源管理器识别；

SCARD_STATE_UNAVAILABLE---读卡器的实际状态是不可用的；

SCARD_STATE_EMPTY---读卡器中没有智能卡；

SCARD_STATE_PRESENT---读卡器中有一个智能卡；

SCARD_STATE_ATRMATCH---读卡器中有一个匹配目标智能卡的智能卡；

SCARD_STATE_EXCLUSIVE---读卡器中的智能卡不被共享；

SCARD_STATE_INUSE---读卡器中的智能卡正被一个或多个应用程序使用，但使用共享连接

SCARD_STATE_MUTE---读卡器中有一个不响应的智能卡

5）SCardFreeMemory函数释放由资源管理器使用SCARD_AUTOALLOCATE分配的内存：

LONG WINAPI SCardFreeMemory(

__in SCARDCONTEXT hContext, //由SCardEstablishContext()返回的资源管理器上下文

__in LPCVOID pvMem //要释放的内存块

);

返回值：成功时：SCARD_S_SUCCESS；失败时：智能卡错误代码。

代码片段：

lReturn = SCardFreeMemory(hSC,

pmszReaders );

if ( SCARD_S_SUCCESS != lReturn )

printf("Failed SCardFreeMemory/n");