ISCard::Transaction-Methode
[Die Transaction-Methode ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Die Smartcardmodule bieten ähnliche Funktionen.]
Die Transaction-Methode führt einen Schreib- und Lesevorgang für das Smartcard-Befehlsobjekt (Anwendungsprotokoll-Dateneinheit)aus. Auf die Antwortzeichenfolge der Smartcard für die Befehlszeichenfolge, die in der Karte definiert ist, die an die Smartcard gesendet wurde, kann nach der Rückgabe dieser Funktion zugegriffen werden.
Syntax
HRESULT Transaction(
[in, out] LPSCARDCMD *ppCmd
);
Parameter
-
ppCmd [ in, out]
-
Ein Zeiger auf das Smartcard-Befehlsobjekt.
Rückgabewert
Die -Methode gibt einen der folgenden möglichen Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Der ppCmd-Parameter ist ungültig. |
|
Ein ungültiger Zeiger wurde in ppCmd übergeben. |
|
Arbeitsspeicher zum Erfüllen der Anforderung ist nicht verfügbar. |
Bemerkungen
Zusätzlich zu den oben aufgeführten COM-Fehlercodes gibt diese Schnittstelle möglicherweise einen Smartcardfehlercode zurück, wenn eine Smartcardfunktion aufgerufen wurde, um die Anforderung abzuschließen. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.
Beispiele
Das folgende Beispiel zeigt das Ausführen eines Schreib- und Lesevorgangs für das Smartcard-Befehlsobjekt.
HRESULT hr;
// pISCard is a pointer to an instance of ISCard.
// pISCardCmd is a pointer to an instance of ISCardCmd,
// and ISCardCmd::BuildCmd has already been called.
hr = pISCard->Transaction(&pISCardCmd);
if (FAILED(hr))
{
printf("Failed ISCard::Transaction\n");
// Take other error handling action as needed.
}
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Ende des Supports (Client) |
Windows XP |
| Ende des Supports (Server) |
Windows Server 2003 |
| Header |
|
| Typbibliothek |
|
| DLL |
|
| IID |
IID _ ISCard ist als 1461AAC3-6810-11D0-918F-00AA00C18068 definiert. |