ISCardCmd::get _ ReplyStatusSW1-Methode

[Die _ Methode get ReplyStatusSW1 steht für die Verwendung in den Betriebssystemen zur Verfügung, 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 _ get ReplyStatusSW1-Methode ruft das Antwort-APDUs SW1-Status byte ab.

Syntax

HRESULT get_ReplyStatusSW1(
  [out] LPBYTE pbySW1
);

Parameter

pbySW1 [ out]

Zeiger auf das Byte, das bei der Rückgabe den Wert des SW1-Byte enthält.

Rückgabewert

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

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

Bemerkungen

Das Sw1-Status-Byte des Antwort-APDU ist schreibgeschützt.

Rufen Sie get _ ReplyStatusSW2auf, um das SW2-Status-Byte des Antwort-APDU abzurufen.

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 das SW1-Status-Byte der Antwort-APDUabgerufen wird. Im Beispiel wird davon ausgegangen, dass pISCardCmd ein gültiger Zeiger auf eine Instanz der ISCardCmd-Schnittstelle ist.

BYTE     bySW1;
HRESULT  hr;

// Retrieve the reply status SW1 byte.
hr = pISCardCmd->get_ReplyStatusSW1(&bySW1);
if (FAILED(hr))
{
  printf("Failed get_ReplyStatusSW1\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 _ ReplyStatusSW2

get _ ReplyStatus

ISCardCmd