Session.OpenBasicChannel 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| 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)。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。