Freigeben über


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 APDU (Application Protocol Data Unit ) aus dem IByteBuffer-Objekt (IStream) in das APDU, das in dieses Schnittstellenobjekt eingeschlossen 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 fehlerhafter Zeiger wurde in pApdu übergeben.
E_OUTOFMEMORY
Nicht genügend Arbeitsspeicher.

 

Bemerkungen

Um die unformatierte APDU aus dem Bytepuffer abzurufen, der über einen IStream zugeordnet ist, der die APDU-Nachricht enthält, rufen Sie get_Apdu auf.

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 Intelligenten Karte Fehlercode zurück, wenn eine Smart Karte-Funktion aufgerufen wurde, um die Anforderung abzuschließen. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Beispiele

Das folgende Beispiel zeigt, wie sie eine APDU aus einem IByteBuffer-Objekt (IStream) in die APDU kopieren, die in ein Schnittstellenobjekt eingeschlossen ist. Im Beispiel wird davon ausgegangen, dass pIByteApdu ein gültiger Zeiger auf eine instance von IByteBuffer ist und dass pISCardCmd ein gültiger Zeiger auf einen instance 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.
}

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
Scarddat.h
Typbibliothek
Scarddat.tlb
DLL
Scardssp.dll
IID
IID_ISCardCmd ist definiert als D5778AE3-43DE-11D0-9171-00AA00C18068

Siehe auch

get_Apdu

ISCardCmd