ISCardISO7816::Verify-Methode
[Die Verify-Methode ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. 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 Verify-Methode erstellt einen APDU-Befehl (Application Protocol Data Unit), der den Vergleich (im Karte) der vom Schnittstellengerät gesendeten Überprüfungsdaten mit den im Karte gespeicherten Referenzdaten (z. B. kennwort) initiiert.
Syntax
HRESULT Verify(
[in] BYTE byRefCtrl,
[in] LPBYTEBUFFER pData,
[in, out] LPSCARDCMD *ppCmd
);
Parameter
-
byRefCtrl [in]
-
Ein Quantifizierer der Verweisdaten. Die Codierung des Referenzsteuerelements P2 folgt.
Wenn der Text leer ist, kann der Befehl entweder verwendet werden, um die Anzahl "X" weiterer zulässiger Wiederholungen abzurufen (SW1-SW2=63CX) oder um zu überprüfen, ob die Überprüfung nicht erforderlich ist (SW1-SW2=9000).
Wert Bedeutung - Keine Informationen
Bitposition: 00000000
P2=00 ist reserviert, um anzugeben, dass kein bestimmter Qualifizierer in den Karten verwendet wird, in denen der Verify-Befehl eindeutig auf die Geheimnisdaten verweist.- Globaler Verweis
Bitposition: 0-------
Ein Beispiel für einen globalen Verweis wäre ein Kennwort.- Spezifischer Verweis
Bitposition: 1-------
Ein Beispiel für eine spezifische Referenz ist df-spezifisches Kennwort.- RFU
Bitposition: -xx----- - Referenzdaten #
Bitposition: ---xxxxx
Die Referenzdatennummer kann z. B. eine Kennwortnummer oder ein kurzer EF-Bezeichner sein. -
pData [in]
-
Ein Zeiger auf die Überprüfungsdaten. Dieser Parameter kann NULL sein. Der Standardwert ist NULL.
-
ppCmd [in, out]
-
Bei der Eingabe ein Zeiger auf ein ISCardCmd-Schnittstellenobjekt oder NULL.
Bei der Rückgabe wird er mit dem APDU-Befehl gefüllt, der von diesem Vorgang erstellt wurde. Wenn ppCmd auf NULL festgelegt wurde, wird intern ein intelligentes KarteISCardCmd-Objekt erstellt und mithilfe des ppCmd-Zeigers zurückgegeben.
Rückgabewert
Die -Methode gibt einen der folgenden möglichen Werte zurück.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Es wurde ein ungültiger Parameter verwendet. |
|
Ein ungültiger Zeiger wurde übergeben. |
|
Nicht genügend Arbeitsspeicher. |
Bemerkungen
Die sicherheitsrelevante status kann als Ergebnis eines Vergleichs geändert werden. Nicht erfolgreiche Vergleiche können im Karte aufgezeichnet werden (z. B. um die Anzahl weiterer Versuche der Verwendung der Referenzdaten zu begrenzen).
Eine Liste aller Methoden, die von dieser Schnittstelle bereitgestellt werden, finden Sie unter ISCardISO7816.
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.
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_ISCardISO7816 ist definiert als 53B6AA68-3F56-11D0-916B-00AA00C18068 |
Siehe auch