SCardDisconnect 函数 (winscard.h)

  • 项目

SCardDisconnect 函数终止以前在调用应用程序和目标读取器中的智能卡之间打开的连接。

语法

LONG SCardDisconnect(
  [in] SCARDHANDLE hCard,
  [in] DWORD       dwDisposition
);

参数

[in] hCard

从上一次调用 SCardConnect 获取的引用值。

[in] dwDisposition

关闭时对连接的读取器中的卡执行的操作。

值 含义
SCARD_LEAVE_CARD
 不要做任何特别的事情。
SCARD_RESET_CARD
 重置卡。
SCARD_UNPOWER_CARD
 关闭卡。
SCARD_EJECT_CARD
 弹出卡。

返回值

此函数根据是成功还是失败返回不同的值。

返回代码 说明
Success
 SCARD_S_SUCCESS。
失败
 错误代码。 有关详细信息，请参阅 智能卡返回值。

注解

如果以前称为 SCardConnect) 的应用程序 (退出，但未调用 SCardDisconnect，则会自动重置卡。

SCardDisconnect 函数是智能卡和读取器访问函数。 有关其他访问函数的详细信息，请参阅 智能卡和读取器访问函数。

示例

以下示例终止指定的智能卡连接。 该示例假定 lReturn 是 LONG 类型的变量，并且 hCardHandle 是从上一次调用 SCardConnect 时收到的有效句柄。


lReturn = SCardDisconnect(hCardHandle, 
                          SCARD_LEAVE_CARD);
if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardDisconnect\n");
    exit(1);  // Or other appropriate action.
}

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 winscard.h
Library Winscard.lib
DLL Winscard.dll

另请参阅

SCardConnect

SCardReconnect