ISCardCmd::p ut-Apdu-Methode _

[Die _ put-Apdu-Methode ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es ist nicht für die Verwendung in Windows Server 2003 mit Service Pack 1 (SP1) und höher, Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems verfügbar. Die Smartcardmodule bieten ähnliche Funktionen.]

Die _ put-Apdu-Methode kopiert die Anwendungsprotokoll-Dateneinheit (Application Protocol Data Unit, APDU) aus dem IByteBuffer (IStream)-Objekt in die APDU, die in diesem Schnittstellenobjekt umschlossen ist.

Syntax

HRESULT put_Apdu(
  [in] LPBYTEBUFFER pApdu
);

Parameter

pApdu [ In]

Zeiger auf die ZU kopierende ISO 7816-4-APDU.

Rückgabewert

Die -Methode gibt einen der folgenden möglichen Werte zurück.

Rückgabecode Beschreibung
S _ OK
Operation erfolgreich abgeschlossen.
E _ INVALIDARG
Der pApdu-Parameter ist ungültig.
E _ POINTER
Ein ungültiger Zeiger wurde in pApdu übergeben.
E _ OUTOFMEMORY
Nicht genügend Arbeitsspeicher.

Bemerkungen

Rufen Sie get _ Apduauf, um das unformatierte APDU aus dem Bytepuffer abzurufen, der über einen IStream zugeordnet ist, der die APDU-Nachricht enthält.

Eine Liste aller von dieser Schnittstelle bereitgestellten Methoden finden Sie unter ISCardCmd.

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, wie ein APDU aus einem IByteBuffer (IStream)-Objekt in die APDU kopiert wird, die in einem Schnittstellenobjekt umschlossen ist. Im Beispiel wird davon ausgegangen, dass pIByteApdu ein gültiger Zeiger auf eine Instanz von IByteBuffer und pISCardCmd ein gültiger Zeiger auf eine Instanz der ISCardCmd-Schnittstelle ist.

HRESULT    hr;


// Set the APDU.
hr = pISCardCmd->put_Apdu(pIByteApdu);
if (FAILED(hr)) 
{
    printf("Failed put_Apdu.\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
Ddat.h
Typbibliothek
Ddat.tlb
DLL
Scardssp.dll
IID
IID _ ISCardCmd ist als D5778AE3-43DE-11D0-9171-00AA00C18068 definiert.

Weitere Informationen

get _ Apdu

ISCardCmd