SCardCancel 函数 (winscard.h)

SCardCancel 函数终止特定资源管理器上下文中所有未完成的操作。

可以取消的唯一请求是需要等待智能卡或用户的外部操作的请求。 任何此类未完成的操作请求都将终止,状态指示操作已取消。 这对于强制终止未完成 的 SCardGetStatusChange 调用特别有用。

语法

LONG SCardCancel(
  [in] SCARDCONTEXT hContext
);

参数

[in] hContext

标识 资源管理器上下文的句柄。 资源管理器上下文由之前对 SCardEstablishContext 的调用设置。

返回值

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

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

注解

SCardCancel 函数是一个智能卡跟踪函数。 有关其他跟踪函数的说明,请参阅 智能卡跟踪函数

示例

以下示例取消指定上下文中所有未完成的操作。 该示例假定 lReturn 是 LONG 类型的现有变量,而 hContext 是从之前对 SCardEstablishContext 的调用收到的有效句柄。


lReturn = SCardCancel( hContext );
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardCancel\n");

要求

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

另请参阅

SCardEstablishContext

SCardGetStatusChange

SCardLocateCards