ISCard::Transaction-Methode
[Die Transaction-Methode ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Die Smartcardmodule bieten ähnliche Funktionen.]
Die Transaction-Methode führt einen Schreib- und Lesevorgang für das Smart Karte-Befehlsobjekt (Anwendungsprotokolldateneinheit) aus. Die Antwortzeichenfolge aus dem intelligenten Karte für die Befehlszeichenfolge, die in der Karte definiert ist, die an die intelligente Karte 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 Smart Karte-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. |
|
In ppCmd wurde ein ungültiger Zeiger übergeben. |
|
Der Arbeitsspeicher zur Erfüllung der Anforderung ist nicht verfügbar. |
Bemerkungen
Zusätzlich zu den oben aufgeführten COM-Fehlercodes gibt diese Schnittstelle möglicherweise einen Fehlercode für intelligente Karte zurück, wenn eine intelligente Karte-Funktion 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 Smart Karte-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.
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| Ende des Supports (Client) |
Windows XP |
| Ende des Supports (Server) |
Windows Server 2003 |
| Header |
|
| Typbibliothek |
|
| DLL |
|
| IID |
IID_ISCard ist definiert als 1461AAC3-6810-11D0-918F-00AA00C18068 |
Siehe auch