Freigeben über

ISCardAuth::GetChallenge-Methode

  • Artikel

[Die GetChallenge-Methode steht für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen zur Verfügung. 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 GetChallenge-Methode gibt eine Herausforderung aus dem intelligenten Karte zurück.

Syntax

HRESULT GetChallenge(
  [in, optional] LONG         lAlgoID,
  [in]           LONG         lLengthOfChallenge,
  [in]           LPBYTEBUFFER pParam,
  [in, out]      LPBYTEBUFFER *pBuffer
);

Parameter

lAlgoID [in, optional]

Algorithmus, der beim Authentifizierungsprozess verwendet werden soll.

lLengthOfChallenge [in]

Maximale Länge der erwarteten Antwort.

pParam [in]

Ein IByteBuffer-Objekt , das anbieterspezifische Parameter des Authentifizierungsprozesses enthält.

pBuffer [in, out]

Zeigt bei der Eingabe auf den Puffer.

Enthält bei der Ausgabe die Anforderungsdaten aus dem Karte.

Rückgabewert

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

Rückgabecode Beschreibung
S_OK
 Operation erfolgreich abgeschlossen.
E_INVALIDARG
 Ungültiger Parameter.
E_POINTER
 Ein ungültiger Zeiger wurde übergeben.
E_OUTOFMEMORY
 Nicht genügend Arbeitsspeicher.

 

Bemerkungen

Eine Liste aller Methoden, die von dieser Schnittstelle bereitgestellt werden, finden Sie unter ISCardAuth.

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

Siehe auch

ISCardAuth