语言

Session.OpenBasicChannel 方法

定义

重载

名称 说明
OpenBasicChannel(Byte[])

提供此方法是为了简化移动应用程序的开发,并与现有应用程序保持一致。

OpenBasicChannel(Byte[], SByte)

获取对基本通道的访问权限,如 ISO/IEC 7816-4 规范(编号为 0 的规范)中所述。

OpenBasicChannel(Byte[])

提供此方法是为了简化移动应用程序的开发,并与现有应用程序保持一致。

[Android.Runtime.Register("openBasicChannel", "([B)Landroid/se/omapi/Channel;", "", ApiSince=28)]
public Android.SE.Omapi.Channel? OpenBasicChannel(byte[]? aid);
[<Android.Runtime.Register("openBasicChannel", "([B)Landroid/se/omapi/Channel;", "", ApiSince=28)>]
member this.OpenBasicChannel : byte[] -> Android.SE.Omapi.Channel

参数

aid
Byte[]

要在此通道上选择的 Applet 的 AID,作为字节数组,如果未选择 Applet,则为 null。

返回

如果可用或为 null,则为 Channel 的实例。

属性

注解

提供此方法是为了简化移动应用程序的开发,并与现有应用程序保持一致。 此方法等效于 openBasicChannel(aid, P2=0x00)

Java文档android.se.omapi.Session.openBasicChannel(byte[])。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于

OpenBasicChannel(Byte[], SByte)

获取对基本通道的访问权限,如 ISO/IEC 7816-4 规范(编号为 0 的规范)中所述。

[Android.Runtime.Register("openBasicChannel", "([BB)Landroid/se/omapi/Channel;", "", ApiSince=28)]
public Android.SE.Omapi.Channel? OpenBasicChannel(byte[]? aid, sbyte p2);
[<Android.Runtime.Register("openBasicChannel", "([BB)Landroid/se/omapi/Channel;", "", ApiSince=28)>]
member this.OpenBasicChannel : byte[] * sbyte -> Android.SE.Omapi.Channel

参数

aid
Byte[]

要在此通道上选择的 Applet 的 AID,作为字节数组,如果未选择 Applet,则为 null。

p2
SByte

在此通道上执行的 SELECT APDU 的 P2 参数。

返回

如果可用或为 null,则为 Channel 的实例。

属性

注解

获取对基本通道的访问权限,如 ISO/IEC 7816-4 规范(编号为 0 的规范)中所述。 获取的对象是 Channel 类的实例。 如果 AID 为 null,则表示在此通道上不选择 Applet,并且使用默认小程序。 如果定义了 AID,则选择相应的小程序。 设备应用程序打开此通道后,此设备应用程序将被视为“锁定”,此方法的其他调用将返回 null,直到通道关闭。 某些安全元素(如 UICC)可能始终将基本通道锁定(即返回 null 给应用程序),以防止访问基本通道,而另一些元素可能会返回对命令实现某种筛选的通道对象,将接受的命令集限制为较小的集。 建议 UICC 拒绝向特定小程序打开基本通道,方法是始终向此类请求应答 null。 对于其他安全元素,建议接受在默认小程序上打开基本通道,直到在基本通道上选择另一个小程序。 由于重置不再选择默认小程序,因此传输 API 的实现应保证 openBasicChannel(null) 命令将返回 null,直到重置发生。 使用以前的版本(V2.05)无法设置 P2 值,此值始终设置为“00”。除具体需求外,建议将 P2 保留为“00”。 建议设备允许 P2 的所有值,但只有以下值是必需的:“00”, “04”、“08”、“0C”(如 [2]中定义)此方法中基础 SELECT 命令的实现应基于 ISO 7816-4,具有以下选项:ul>li CLA = '00'</li><>li INS = 'A4'</li li>><P1 = '04' (按 DF 名称/应用程序标识符选择)</li<>/ul><<>

可以使用 byte[] getSelectResponse()检索选择响应数据。 API 应按如下所示处理收到的状态字。 如果状态词指示 Secure Element 能够打开通道(例如状态字“90 00”或引用 ISO-7816-4 中的警告的状态单词:“62 XX”或“63 XX”),则 API 应保持通道打开状态,下一个 getSelectResponse() 将返回收到的状态字。 其他接收的状态代码指示 Secure Element 无法打开通道应被视为错误,并且不应打开相应的通道。 提供不带 P2 作为参数的函数以实现向后兼容性,并将回退到具有 P2='00' 的 select 命令。

Java文档android.se.omapi.Session.openBasicChannel(byte[], byte)。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于