ISCardISO7816::Verify 方法
[ Verify 方法可用于“要求”部分中指定的操作系统。 它不适用于 Windows Server 2003 Service Pack 1 (SP1) 及更高版本、Windows Vista、Windows Server 2008 和操作系统的后续版本。 智能卡模块提供类似的功能。]
Verify 方法 (APDU) 命令构造应用程序协议数据单元,该命令使用存储在 卡 (中的引用数据(例如密码) )启动从接口设备发送的验证数据卡) 中的比较 (。
语法
HRESULT Verify(
[in] BYTE byRefCtrl,
[in] LPBYTEBUFFER pData,
[in, out] LPSCARDCMD *ppCmd
);
parameters
-
byRefCtrl [in]
-
引用数据的限定符。 引用控件 P2 的编码如下。
当正文为空时,可以使用 命令检索 (SW1-SW2=63CX) 的进一步允许重试次数“X”,或者检查是否不需要验证 (SW1-SW2=9000) 。
值 含义 - 无信息
位位置:00000000
保留 P2=00 以指示验证命令明确引用机密数据的卡中未使用任何特定限定符。- 全局引用
位位置:0-------
全局引用的一个示例是密码。- 特定引用
位位置:1-------
特定引用的一个示例是 DF 特定密码。- RFU
位位置:-xx----- - 引用数据#
位位置:---xxxxx
例如,引用数据编号可以是密码编号或短 EF 标识符。 -
pData [in]
-
指向验证数据的指针。 此参数可以为 NULL。 默认值为 NULL。
-
ppCmd [in, out]
-
输入时,指向 ISCardCmd 接口对象的指针或 NULL。
返回时,会用此操作构造的 APDU 命令填充它。 如果 ppCmd 设置为 NULL,则会使用 ppCmd 指针在内部创建并返回智能卡ISCardCmd 对象。
返回值
方法返回以下可能值之一。
返回代码 | 说明 |
---|---|
|
操作已成功完成。 |
|
使用了无效的参数。 |
|
传入了错误的指针。 |
|
内存不足。 |
备注
安全状态可能会因比较而修改。 例如,可能会将失败的比较记录在卡 (中,以限制) 引用数据的进一步使用尝试次数。
有关此接口提供的所有方法的列表,请参阅 ISCardISO7816。
除了上面列出的 COM 错误代码外,如果调用智能卡函数来完成请求,则此接口可能返回智能卡错误代码。 有关详细信息,请参阅 智能卡返回值。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows XP [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
客户端支持终止 |
Windows XP |
终止服务器支持 |
Windows Server 2003 |
标头 |
|
类型库 |
|
DLL |
|
IID |
IID_ISCardISO7816定义为 53B6AA68-3F56-11D0-916B-00AA00C18068 |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈