Metodo ISCardISO7816::CancelBinary
[Il metodo CancelBinary è 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 CancelBinary costruisce un comando APDU ( Application Protocol Data Unit ) che imposta in sequenza parte del contenuto di un file elementare allo stato logico cancellato, a partire da un offset specificato.
Sintassi
HRESULT EraseBinary(
[in] BYTE byP1,
[in] BYTE byP2,
[in] LPBYTEBUFFER pData,
[in, out] LPSCARDCMD *ppCmd
);
Parametri
-
byP1 [in]
-
Posizione RFU.
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 cancellare (nelle unità dati) dall'inizio del file.
Se b8=0 in P1, P1 || P2 è l'offset del primo byte da cancellare (nelle unità dati) dall'inizio del file.
Se il campo dati è presente, codifica l'offset della prima unità dati non da cancellare. Questa offset deve essere superiore a quello codificato in P1-P2. Quando il campo dati è vuoto, il comando cancella fino alla fine del file.
-
byP2 [in]
-
Posizione RFU.
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 cancellare (nelle unità dati) dall'inizio del file.
Se b8=0 in P1, P1 || P2 è l'offset del primo byte da cancellare (nelle unità dati) dall'inizio del file.
Se il campo dati è presente, codifica l'offset della prima unità dati non da cancellare. Questa offset deve essere superiore a quello codificato in P1-P2. Quando il campo dati è vuoto, il comando cancella fino alla fine del file.
-
pData [in]
-
Puntatore ai dati che specifica l'intervallo di cancellazione. Questo parametro può essere 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 usando il puntatore ppCmd.
Valore restituito
Il metodo restituisce uno dei valori possibili seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Operazione riuscita. |
|
Parametro non valido passato. |
|
Un puntatore non valido è stato passato. |
|
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 da elaborare.
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 interrompe 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 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