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[]
このチャネルで選択するアプレットの AID をバイト配列として、またはアプレットを選択しない場合は null。
返品
チャネルのインスタンス (使用可能な場合) または null。
- 属性
注釈
この方法は、モバイル アプリケーションの開発を容易にし、既存のアプリケーションとの適合性を高めるために提供されます。 このメソッドは、openBasicChannel(aid, P2=0x00) と同じです。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
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[]
このチャネルで選択するアプレットの AID をバイト配列として、またはアプレットを選択しない場合は null。
- p2
- SByte
このチャネルで実行される SELECT APDU の P2 パラメーター。
返品
チャネルのインスタンス (使用可能な場合) または null。
- 属性
注釈
ISO/IEC 7816-4 仕様 (数値 0 を持つもの) で定義されている基本的なチャネルへのアクセスを取得します。 取得したオブジェクトは、Channel クラスのインスタンスです。 AID が null の場合は、このチャネルでアプレットを選択せず、既定のアプレットが使用されることを意味します。 AID が定義されている場合は、対応するアプレットが選択されます。 このチャネルがデバイス アプリケーションによって開かれると、このデバイス アプリケーションによって "ロック" と見なされ、チャネルが閉じられるまで、このメソッドの他の呼び出しは null を返します。 一部の Secure Elements (UICC など) は、基本チャネルへのアクセスを防ぐために基本チャネルを常にロックしたままにする (つまり、アプリケーションに null を返す) 場合もあれば、コマンドに対して何らかのフィルター処理を実装するチャネル オブジェクトを返す場合があり、受け入れられたコマンドのセットをより小さなセットに制限するものもあります。 UICC では、このような要求に対して常に null に応答することで、特定のアプレットへの基本的なチャネルのオープンを拒否することをお勧めします。 その他のセキュアエレメントについては、基本チャネルで別のアプレットが選択されるまで、デフォルトアプレットで基本チャネルを開くのを受け入れることをお勧めします。 既定のアプレットをもう一度選択するリセット以外の方法はないため、トランスポート API の実装では、リセットが発生するまで openBasicChannel(null) コマンドが null を返すようにする必要があります。 以前のリリース (V2.05) では、P2 値を設定できませんでした。この値は常に '00' に設定されていました。特定のニーズを除き、P2 を '00' に維持することをお勧めします。 デバイスで P2 のすべての値を許可することをお勧めしますが、必須の値は '00'、'04'、 '08', '0C'([2]で定義) このメソッド内の基になる SELECT コマンドの実装は、ISO 781 に基づいている必要があります 次のオプションを含む 6-4: <ul><li>CLA = '00'</li><li>INS = 'A4'</li><li>P1 = '04' (DF 名/アプリケーション識別子で選択))</li></ul>
select 応答データは byte[] getSelectResponse() で取得できます。 API は、受信したステータス ワードを次のように処理します。 状態ワードが、Secure Element がチャネル (例: ステータスワード '90 00' またはステータスワードが ISO-7816-4: '62 XX' または '63 XX' の警告を参照) を開くことができることを示す場合、API はチャネルを開いたままにし、次の getSelectResponse() は受信したステータスワードを返します。 Secure Element がチャネルを開けなかったことを示す他の受信状態コードは、エラーと見なされ、対応するチャネルは開かないようにする必要があります。 パラメーターとして P2 を持たない関数は下位互換性のために提供され、P2='00' の select コマンドにフォールバックします。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。