Metodo ISCardISO7816::GetData

Articolo
06/13/2023

[Il metodo GetData è 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 GetData costruisce un comando APDU ( Application Protocol Data Unit ) che recupera un singolo oggetto dati primitivo o un set di oggetti dati (contenuti in un oggetto dati costruito), a seconda del tipo di file selezionato.

Sintassi

HRESULT GetData(
  [in]      BYTE       byP1,
  [in]      BYTE       byP2,
  [in]      LONG       lBytesToGet,
  [in, out] LPSCARDCMD *ppCmd
);

Parametri

byP1 [in]

Parametri.

Valore	Significato
0000 - 003F	RFU
0040 - 00FF	BER-TLV tag (1 byte) in P2
0100 - 01FF	Dati dell'applicazione (codifica proprietaria)
0200 - 02FF	SIMPLE-TLV tag in P2
0300 - 03FF	RFU
0400 - 04FF	Tag BER-TLV (2 byte) in P1-P2

byP2 [in]

Parametri.

Valore	Significato
0000 - 003F	RFU
0040 - 00FF	BER-TLV tag (1 byte) in P2
0100 - 01FF	Dati dell'applicazione (codifica proprietaria)
0200 - 02FF	SIMPLE-TLV tag in P2
0300 - 03FF	RFU
0400 - 04FF	Tag BER-TLV (2 byte) in P1-P2

lBytesToGet [in]

Numero di byte previsti nella risposta.

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 completata correttamente.
E_INVALIDARG	Parametro non valido.
E_POINTER	È stato passato un puntatore non valido.
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 leggere. Le condizioni di sicurezza dipendono dai criteri della scheda e possono essere modificate tramite ExternalAuthenticate, InternalAuthenticate, ISCardAuthAuth e così via.

Per selezionare un file, chiamare SelectFile.

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

ExternalAuthenticate
InternalAuthenticate
ISCardAuth
ISCardISO7816
PutData
SelectFile

Condividi tramite