Metodo ISCardISO7816::Verify

Articolo
06/13/2023

[Il metodo Verify è 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 Verify costruisce un comando APDU ( Application Protocol Data Unit ) che avvia il confronto (nella scheda) dei dati di verifica inviati dal dispositivo di interfaccia con i dati di riferimento archiviati nella scheda (ad esempio, password).

Sintassi

HRESULT Verify(
  [in]      BYTE         byRefCtrl,
  [in]      LPBYTEBUFFER pData,
  [in, out] LPSCARDCMD   *ppCmd
);

Parametri

byRefCtrl [in]

Quantificatore dei dati di riferimento. Di seguito è riportato il codice del controllo di riferimento P2.

Quando il corpo è vuoto, il comando può essere usato per recuperare il numero "X" di ulteriori tentativi consentiti (SW1-SW2=63CX) o per verificare se la verifica non è necessaria (SW1-SW2=9000).

Valore	Significato
Nessuna informazione	Posizione bit: 00000000 P2=00 è riservato per indicare che non viene usato alcun qualificatore specifico nelle schede in cui il comando verify fa riferimento ai dati segreti in modo univoco.
Riferimento globale	Posizione bit: 0------- Un esempio di Riferimento globale sarebbe una password.
Riferimento specifico	Posizione bit: 1------- Un esempio di riferimento specifico è la password specifica di DF.
RFU	Posizione bit: -xx-----
Dati di riferimento #	Posizione bit: ---xxxxx Il numero di dati di riferimento può essere, ad esempio, un numero di password o un identificatore ef breve.

pData [in]

Puntatore ai dati di verifica. Questo parametro può essere NULL. Il valore predefinito è NULL.

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 e restituito internamente un oggetto ISCardCmd tramite il puntatore ppCmd.

Valore restituito

Il metodo restituisce uno dei valori possibili seguenti.

Codice restituito	Descrizione
S_OK	Operazione riuscita.
E_INVALIDARG	È stato utilizzato un parametro non valido.
E_POINTER	È stato passato un puntatore non valido.
E_OUTOFMEMORY	Memoria insufficiente.

Commenti

Lo stato di sicurezza può essere modificato in seguito a un confronto. I confronti non riusciti possono essere registrati nella scheda (ad esempio, per limitare il numero di ulteriori tentativi di utilizzo dei dati di riferimento).

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 della 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	Scardssp.h
Libreria dei tipi	Scardsrv.tlb
DLL	Scardssp.dll
IID	IID_ISCardISO7816 è definito come 53B6AA68-3F56-11D0-916B-00AA00C18068

Vedi anche

ISCardISO7816

Condividi tramite