Metodo ISCardISO7816::GetChallenge
[Il metodo GetChallenge è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Non è disponibile per l'uso in Windows Server 2003 con Service Pack 1 (SP1) e versioni successive, Windows Vista, Windows Server 2008 e versioni successive del sistema operativo. I moduli smart card offrono funzionalità simili.
Il metodo GetChallenge costruisce un comando APDU ( Application Protocol Data Unit ) che genera una richiesta (ad esempio un numero casuale) da usare in una procedura correlata alla sicurezza.
Sintassi
HRESULT GetChallenge(
[in] LONG lBytesExpected,
[in, out] LPSCARDCMD *ppCmd
);
Parametri
-
lBytesExpected [in]
-
Lunghezza massima della risposta prevista.
-
ppCmd [in, out]
-
In input, un puntatore a un oggetto interfaccia ISCardCmd o NULL.
Al ritorno, viene riempito con il comando APDU costruito da questa operazione. Se ppCmd è stato impostato su NULL, viene creato internamente un oggetto ISCardCmd e restituito tramite il puntatore ppCmd.
Valore restituito
Il metodo restituisce uno dei valori possibili seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata correttamente. |
|
Parametro non valido. |
|
Un puntatore non valido è stato passato. |
|
Memoria insufficiente. |
Commenti
La sfida è valida almeno per il comando successivo.
Per un elenco di tutti i metodi forniti da questa interfaccia, vedere ISCardISO7816.
Oltre ai codici di errore COM elencati in precedenza, questa interfaccia può restituire un codice di errore della smart card se è stata chiamata una funzione smart card per completare la richiesta. Per altre informazioni, vedere Valori restituiti smart card.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows XP [solo app desktop] |
| Server minimo supportato |
Windows Server 2003 [solo app desktop] |
| Fine del supporto client |
Windows XP |
| Fine del supporto server |
Windows Server 2003 |
| Intestazione |
|
| Libreria dei tipi |
|
| DLL |
|
| IID |
IID_ISCardISO7816 è definito come 53B6A68-3F56-11D0-916B-00AA0C18068 |
Vedi anche