Partager via


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

  1. Créez une interface ISCard et connectez-vous à un carte intelligent.
  2. Créez une interface ISCardCmd .
  3. 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.
  4. Exécutez la commande sur le smart carte en appelant la méthode d’interface ISCard appropriée.
  5. Évaluez la réponse retournée.
  6. Répétez la procédure si nécessaire.
  7. 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
Scarddat.h
Bibliothèque de types
Scarddat.tlb
DLL
Scardssp.dll
IID
IID_ISCardCmd est défini comme D5778AE3-43DE-11D0-9171-00AA00C18068