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");