Interface ISCardCmd
[L’interface ISCardCmd peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il n’est pas disponible pour une utilisation dans Windows Server 2003 avec Service Pack 1 (SP1) et versions ultérieures, Windows Vista, Windows Server 2008 et les versions ultérieures du système d’exploitation. Les modules de carte à puce offrent des fonctionnalités similaires.]
L’interface ISCardCmd fournit les méthodes nécessaires pour construire et gérer uneunité de données de protocole carte application intelligente (APDU). Cette interface encapsule deux mémoires tampons :
- La mémoire tampon APDU contient la séquence de commandes qui sera envoyée au carte.
- La mémoire tampon APDUReply contient les données retournées par le carte après l’exécution de la commande APDU (ces données sont également appelées APDU de retour).
L’exemple suivant montre une utilisation classique de l’interface ISCardCmd . L’interface ISCardCmd est utilisée pour générer un APDU.
Pour envoyer une transaction à un carte spécifique
- Créez une interface ISCard et connectez-vous à un carte intelligent.
- Créez une interface ISCardCmd .
- Générez une commande APDU carte intelligente à l’aide de l’interface ISCardISO7816 ou de l’une des méthodes de génération ISCardCmd.
- Exécutez la commande sur le smart carte en appelant la méthode d’interface ISCard appropriée.
- Évaluez la réponse retournée.
- Répétez la procédure si nécessaire.
- Libérez l’interface ISCardCmd et d’autres en fonction des besoins.
Membres
L’interface ISCardCmd hérite de l’interface IDispatch. ISCardCmd a également les types de membres suivants :
Méthodes
L’interface ISCardCmd utilise ces méthodes.
| Méthode | Description |
|---|---|
| BuildCmd | Construit une commande APDU valide pour la transmission à un carte intelligent. |
| Effacer | Efface les mémoires tampons de message APDU et de réponse. |
| Encapsuler | Encapsule la commande APDU donnée dans une autre commande APDU pour la transmission à un carte intelligent. |
Propriétés
L’interface ISCardCmd a ces propriétés.
| Propriété | Type d’accès | Description |
|---|---|---|
|
AlternateClassId |
Lecture/écriture |
Valeur d’ID de classe alternative actuelle. |
|
Apdu |
Lecture/écriture |
Unité de données de protocole d’application brute (APDU). |
|
ApduLength |
Lecture seule |
Longueur de l’APDU. |
|
ApduReply |
Lecture/écriture |
Répondre à APDU. |
|
ApduReplyLength |
Lecture/écriture |
Longueur de l’APDU de réponse. |
|
Classid |
Lecture/écriture |
ID de classe de l’APDU. |
|
Données |
Lecture seule |
Champ de données de l’API. |
|
InstructionId |
Lecture/écriture |
Octet d’ID d’instruction de l’APDU. |
|
LeField |
Lecture seule |
Le champ de l’APDU. |
|
Nad |
Lecture/écriture |
Adresse du nœud. |
|
P1 |
Lecture/écriture |
Premier octet de paramètre de l’APDU. |
|
P2 |
Lecture/écriture |
Second paramètre byte de l’APDU. |
|
P3 |
Lecture seule |
Troisième octet de paramètre de l’APDU. |
|
ReplyNad |
Lecture/écriture |
Adresse de nœud utilisée par le carte dans le message de réponse. |
|
ReplyStatus |
Lecture/écriture |
Répondre au message APDU status mot. |
|
ReplyStatusSW1 |
Lecture seule |
Répondre au message d’APDU SW1 status octet. |
|
ReplyStatusSW2 |
Lecture seule |
Répondre au message d’APDU SW2 status octet. |
|
Type |
Lecture seule |
Réservé pour un usage futur. |
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2003 [applications de bureau uniquement] |
| Fin de la prise en charge des clients |
Windows XP |
| Fin de la prise en charge des serveurs |
Windows Server 2003 |
| En-tête |
|
| Bibliothèque de types |
|
| DLL |
|
| IID |
IID_ISCardCmd est défini comme D5778AE3-43DE-11D0-9171-00AA00C18068 |