SCardCancel 函数 (winscard.h)
SCardCancel 函数终止特定资源管理器上下文中所有未完成的操作。
可以取消的唯一请求是需要等待智能卡或用户的外部操作的请求。 任何此类未完成的操作请求都将终止,状态指示操作已取消。 这对于强制终止未完成 的 SCardGetStatusChange 调用特别有用。
语法
LONG SCardCancel(
[in] SCARDCONTEXT hContext
);
参数
[in] hContext
标识 资源管理器上下文的句柄。 资源管理器上下文由之前对 SCardEstablishContext 的调用设置。
返回值
此函数根据是成功还是失败返回不同的值。
返回代码 | 说明 |
---|---|
|
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 |