Metodo ISCardISO7816::UpdateBinary

Articolo
06/13/2023

[Il metodo UpdateBinary è 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 UpdateBinary costruisce un comando APDU ( Application Protocol Data Unit ) che aggiorna i bit presenti in un file elementare con i bit specificati nel comando APDU.

Sintassi

HRESULT UpdateBinary(
  [in]      BYTE         byP1,
  [in]      BYTE         byP2,
  [in]      LPBYTEBUFFER pData,
  [in, out] LPSCARDCMD   *ppCmd
);

Parametri

byP1 [in]

Offset alla posizione di scrittura (aggiornamento) nel file binario dall'inizio del file binario. 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 aggiornare nelle unità dati dall'inizio del file. Se b8=0 in P1, P1 || P2 è l'offset del primo byte da aggiornare nelle unità dati dall'inizio del file.

byP2 [in]

pData [in]

Puntatore alla stringa di unità dati da aggiornare.

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
S_OK	Operazione completata correttamente.
E_INVALIDARG	Parametro non valido.
E_POINTER	Un puntatore non valido è stato passato.
E_OUTOFMEMORY	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	Scardssp.h
Libreria dei tipi	Scardsrv.tlb
DLL	Scardssp.dll
IID	IID_ISCardISO7816 è definito come 53B6A68-3F56-11D0-916B-00AA0C18068

Vedi anche

CancelBinary
ISCardISO7816
ReadBinary
WriteBinary

Condividi tramite