ISCardISO7816::UpdateBinary 方法

[UpdateBinary 方法可用于"要求"部分中指定的操作系统。 它不适用于 Windows Server 2003 Service Pack 1 (SP1) 及更高版本、Windows Vista、Windows Server 2008 以及操作系统的后续版本。 智能卡模块提供类似的功能。]

UpdateBinary 方法使用 APDU () 命令构造应用程序协议数据单元,该命令使用 APDU 命令中给定的位更新基本文件中存在位。

语法

HRESULT UpdateBinary(
  [in]      BYTE         byP1,
  [in]      BYTE         byP2,
  [in]      LPBYTEBUFFER pData,
  [in, out] LPSCARDCMD   *ppCmd
);

parameters

byP1 []

从二进制文件 () 位置到二进制文件中的写入位置的偏移量。 如果 P1 中的 b8=1,则 b7 和 b6 的 P1 设置为零 (RFU 位) ,b5 到 b1 的 P1 是一个短 EF 标识符,P2 是数据单位中要更新的第一个字节的偏移量,从文件开头开始。 如果 P1 中的 b8=0,则 P1 P2 是数据单位中要更新的第一个字节与文件开头 | | 的偏移量。

byP2 []

从二进制文件 () 位置到二进制文件中的写入位置的偏移量。 如果 P1 中的 b8=1,则 b7 和 b6 的 P1 设置为零 (RFU 位) ,b5 到 b1 的 P1 是一个短 EF 标识符,P2 是数据单位中要更新的第一个字节的偏移量,从文件开头开始。 如果 P1 中的 b8=0,则 P1 P2 是数据单位中要更新的第一个字节与文件开头 | | 的偏移量。

pData []

指向要更新的数据单元字符串的指针。

ppCmd [in、out]

输入时,指向 ISCardCmd 接口对象或 NULL 的指针。

返回时,会用此操作构造的 APDU 命令填充该参数。 如果 ppCmd 设置为 NULL,智能卡 ISCardCmd 对象在内部创建,然后使用 ppCmd 指针返回。

返回值

方法返回以下可能值之一。

返回代码 说明
S _ OK
操作已成功完成。
E _ INVALIDARG
参数无效。
E _ 指针
传入了错误的指针。
E _ OUTOFMEMORY
内存不足。

备注

只有在智能卡的安全状态满足正在处理的基本文件的安全属性时,才能执行封装的命令。

当命令包含有效的短基本标识符时,它会将文件设置为当前基本文件。

无法清除没有透明结构的基本文件。 如果应用于没有透明结构的基本文件,封装的命令将中止。

有关此接口提供的所有方法的列表,请参阅 ISCardISO7816。

除了上面列出的 COM 错误代码,如果调用智能卡函数来完成请求,此接口可能返回智能卡错误代码。 有关详细信息,请参阅 智能卡返回值

要求

要求
最低受支持的客户端
Windows仅 [ XP 桌面应用]
最低受支持的服务器
Windows仅服务器 2003 [ 桌面应用]
客户端支持结束
Windows XP
服务器支持结束
Windows Server 2003
标头
Scardssp.h
类型库
Scardsrv.tlb
DLL
Scardssp.dll
IID
IID _ ISCardISO7816 定义为 53B6AA68-3F56-11D0-916B-00AA00C18068

另请参阅

EraseBinary

ISCardISO7816

ReadBinary

WriteBinary