Metodo ISCardISO7816::ReadBinary
[Il metodo ReadBinary è 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 ReadBinary costruisce un comando APDU ( Application Protocol Data Unit ) che acquisisce un messaggio di risposta che fornisce tale parte del contenuto di un file elementare strutturato trasparente.
Sintassi
HRESULT ReadBinary(
[in] BYTE byP1,
[in] BYTE byP2,
[in] LONG lBytesToRead,
[in, out] LPSCARDCMD *ppCmd
);
Parametri
-
byP1 [in]
-
Il campo P1-P2, offset al primo byte da leggere dall'inizio del file. Se b8=1 in P1, b7 e b6 di P1 sono impostati su zero (bit RFU), b5 su b1 di P1 sono un identificatore EF breve e P2 è l'offset del primo byte da leggere nelle unità dati dall'inizio del file. Se b8=0 in P1, P1|| P2 è l'offset del primo byte da leggere nelle unità dati dall'inizio del file.
-
byP2 [in]
-
Il campo P1-P2, offset al primo byte da leggere dall'inizio del file. Se b8=1 in P1, b7 e b6 di P1 sono impostati su zero (bit RFU), b5 su b1 di P1 sono un identificatore EF breve e P2 è l'offset del primo byte da leggere nelle unità dati dall'inizio del file. Se b8=0 in P1, P1|| P2 è l'offset del primo byte da leggere nelle unità dati dall'inizio del file.
-
lBytesToRead [in]
-
Numero di byte da leggere da Entity Framework trasparente.
Se il campo Le contiene solo zeri, entro il limite di 256 per lunghezza breve o 65536 per lunghezza estesa, tutti i byte fino alla fine del file devono essere letti.
-
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 |
|---|---|
|
Operazione completata correttamente. |
|
Parametro non valido. |
|
È stato passato un puntatore non valido. |
|
Memoria insufficiente. |
Commenti
Il comando incapsulato può essere eseguito solo se lo stato di sicurezza della smart card soddisfa gli attributi di sicurezza del file elementare in fase di elaborazione.
Quando il comando contiene un identificatore elementare breve valido, imposta il file come file elementare corrente.
I file elementari senza una struttura trasparente non possono essere cancellati. Il comando incapsulato viene interrotto se applicato a un file elementare senza una struttura trasparente.
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 |
|
| Libreria dei tipi |
|
| DLL |
|
| IID |
IID_ISCardISO7816 è definito come 53B6AA68-3F56-11D0-916B-00AA00C18068 |
Vedi anche