Session.OpenBasicChannel Méthode

[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

Paramètres

Retours

instance de canal si disponible ou null.

Attributs

RegisterAttribute

Remarques

Cette méthode est fournie pour faciliter le développement d’applications mobiles et pour la compatibilité avec les applications existantes. Cette méthode équivaut à openBasicChannel(aid, P2=0x00)

Java documentation pour android.se.omapi.Session.openBasicChannel(byte[]).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

[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

Paramètres

Retours

instance de canal si disponible ou null.

Attributs

RegisterAttribute

Remarques

Obtenez un accès au canal de base, tel que défini dans la spécification ISO/IEC 7816-4 (celle qui a le numéro 0). L’objet obtenu est une instance de la classe Channel. Si l’AIDE est null, cela signifie qu’aucune applet n’est sélectionnée sur ce canal et que l’applet par défaut est utilisée. Si l’AIDE est définie, l’applet correspondante est sélectionnée. Une fois que ce canal a été ouvert par une application d’appareil, il est considéré comme « verrouillé » par cette application d’appareil, et d’autres appels à cette méthode retournent null, jusqu’à ce que le canal soit fermé. Certains éléments sécurisés (comme l’UICC) peuvent toujours conserver le canal de base verrouillé (c’est-à-dire renvoyer null aux applications), pour empêcher l’accès au canal de base, tandis que d’autres peuvent renvoyer un objet de canal implémentant un type de filtrage sur les commandes, limitant l’ensemble de commandes acceptées à un ensemble plus petit. Il est recommandé à l’UICC de rejeter l’ouverture du canal de base sur une applet spécifique, en répondant toujours à null à une telle demande. Pour d’autres éléments sécurisés, il est recommandé d’accepter d’ouvrir le canal de base sur l’applet par défaut jusqu’à ce qu’une autre applet soit sélectionnée sur le canal de base. Comme il n’existe aucun autre moyen qu’une réinitialisation de sélectionner à nouveau l’applet par défaut, l’implémentation de l’API de transport doit garantir que la commande openBasicChannel(null) retourne null jusqu’à ce qu’une réinitialisation se produise. Avec la version précédente (V2.05), il n’était pas possible de définir la valeur P2, cette valeur était toujours définie sur « 00 ». À l’exception des besoins spécifiques, il est recommandé de conserver P2 à « 00 ». Il est recommandé que l’appareil autorise toutes les valeurs pour P2, mais seules les valeurs suivantes sont obligatoires : « 00 », '04', '08', '0C'(tel que défini dans [2]) L’implémentation de la commande SELECT sous-jacente dans cette méthode doit être basée sur ISO 7816-4 avec les options suivantes : <ul<>li>CLA = '00'</li li>INS = 'A4'</li li<>>P1 = '04' (Select by DF name/application identifier)</li><></ul>

Les données de réponse de sélection peuvent être récupérées avec octet[] getSelectResponse(). L’API doit gérer le mot d’état reçu comme suit. Si le mot d’état indique que l’élément Sécurisé a pu ouvrir un canal (par exemple, le mot d’état « 90 00 » ou les mots d’état référençant un avertissement dans ISO-7816-4 : « 62 XX » ou « 63 XX ») l’API doit conserver le canal ouvert et le prochain getSelectResponse() renvoie le mot d’état reçu. D’autres codes d’état reçus indiquant que l’élément sécurisé n’a pas pu ouvrir un canal doivent être considérés comme une erreur et que le canal correspondant n’est pas ouvert. La fonction sans P2 comme paramètre est fournie pour la compatibilité descendante et revient à une commande select avec P2='00'.

Java documentation pour android.se.omapi.Session.openBasicChannel(byte[], byte).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.