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
S _ OK
Der Vorgang wurde erfolgreich abgeschlossen.
E _ INVALIDARG
Der ppCmd-Parameter ist ungültig.
E _ POINTER
Ein ungültiger Zeiger wurde in ppCmd übergeben.
E _ OUTOFMEMORY
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
Scardmgr.h
Typbibliothek
Scardmgr.tlb
DLL
Scardssp.dll
IID
IID _ ISCard ist als 1461AAC3-6810-11D0-918F-00AA00C18068 definiert.

Weitere Informationen

AttachByHandle

AttachByReader

Trennen

get _ Atr

get _ CardHandle

get _ Context

get _ Protocol

_Get Status

ISCard

LockSCard

Anfügen

UnlockSCard