ISCardISO7816::ExternalAuthenticate-Methode
[Die ExternalAuthenticate-Methode 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 ExternalAuthenticate-Methode erstellt einen APDU-Befehl (Application Protocol Data Unit), der den Sicherheitsstatus bedingt aktualisiert und die Identität des Computers überprüft, wenn die Smartcard ihm nicht vertraut.
Der Befehl verwendet das Ergebnis (ja oder nein) der Berechnung durch die Karte (basierend auf einer zuvor von der Karte ausgegebenen Herausforderung, z. B. durch den INS GET CHALLENGE-Befehl), einem auf der Karte gespeicherten Schlüssel (möglicherweise geheimnis) und Authentifizierungsdaten, die vom Schnittstellengerät übertragen _ _ werden.
Syntax
HRESULT ExternalAuthenticate(
[in] BYTE byAlgorithmRef,
[in] BYTE bySecretRef,
[in] LPBYTEBUFFER pChallenge,
[in, out] LPSCARDCMD *ppCmd
);
Parameter
-
byAlgorithmRef [ In]
-
Der Verweis des Algorithmus auf der Karte.
Wenn dieser Wert 0 (null) ist, bedeutet dies, dass keine Informationen angegeben werden. Der Verweis auf den Algorithmus ist entweder vor dem Ausführen des Befehls bekannt oder wird im Datenfeld bereitgestellt.
-
bySecretRef [ In]
-
Der Verweis des Geheimnisses.
Wert Bedeutung - Keine Informationen
Bitposition: 00000000
Es werden keine Informationen angegeben. Der Verweis auf das Geheimnis ist entweder vor dem Ausführen des Befehls bekannt oder wird im Datenfeld bereitgestellt.- Globaler Verweis
Bitposition: 0-------
Globale Verweisdaten (ein MF-spezifischer Schlüssel).- Spezifischer Verweis
Bitposition: 1-------
Bestimmte Verweisdaten (ein DF-spezifischer Schlüssel).- RFU
Bitposition: -xx-----
00 (andere Werte sind RFU).- Geheimnis
Bitposition: ---xxxxx
Nummer des Geheimnisses. -
pC wiege [ In]
-
Ein Zeiger auf die Authentifizierungsdaten. Dieser Parameter kann NULL sein.
-
ppCmd [ in, out]
-
Bei der Eingabe ein Zeiger auf ein ISCardCmd-Schnittstellenobjekt oder NULL.
Bei der Rückgabe wird er mit dem von diesem Vorgang erstellten APDU-Befehl gefüllt. Wenn ppCmd auf NULL festgelegt wurde, wird intern ein SMARTCARD-ISCardCmd-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. |
|
Ein ungültiger Parameter wurde übergeben. |
|
Ein fehlerhafter Zeiger wurde übergeben. |
|
Nicht genügend Arbeitsspeicher. |
Bemerkungen
Damit der gekapselte Befehl erfolgreich ist, muss die letzte von der Karte erhaltene Herausforderung gültig sein.
Nicht erfolgreiche Vergleiche können auf der Karte aufgezeichnet werden (z. B. um die Anzahl weiterer Versuche der Verwendung der Verweisdaten zu begrenzen).
Eine Liste aller von dieser Schnittstelle bereitgestellten Methoden finden Sie unter ISCardISO7816.
Zusätzlich zu den oben aufgeführten COM-Fehlercodes gibt diese Schnittstelle möglicherweise einen Smartcard-Fehlercode zurück, wenn eine Smartcardfunktion aufgerufen wurde, um die Anforderung zu erfüllen. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.
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 |
|
| Typbibliothek |
|
| DLL |
|
| IID |
IID _ ISCardISO7816 ist als 53B6AA68-3F56-11D0-916B-00AA00C18068 definiert. |