Metodo ISCardCmd::get_Apdu

Articolo
06/13/2023

[Il metodo get_Apdu è 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 get_Apdu recupera l'unità dati APDU ( Application Protocol Data Unit ) non elaborata.

Sintassi

HRESULT get_Apdu(
  [out] LPBYTEBUFFER *ppApdu
);

Parametri

ppApdu [out]: Puntatore al buffer dei byte mappato tramite un oggetto IStream che contiene il messaggio APDU al momento della restituzione.

Valore restituito

Il metodo restituisce uno dei valori possibili seguenti.

Codice restituito	Descrizione
S_OK	Operazione completata correttamente.
E_INVALIDARG	Il parametro ppApdu non è valido.
E_POINTER	Un puntatore non valido è stato passato in ppApdu.
E_OUTOFMEMORY	Memoria insufficiente.

Commenti

Per copiare l'APDU da un oggetto IByteBuffer (IStream) nell'APDU di cui è stato eseguito il wrapping in questo oggetto interfaccia, chiamare put_Apdu.

Per determinare la lunghezza dell'APDU, chiamare get_ApduLength.

Per un elenco di tutti i metodi forniti dall'interfaccia ISCardCmd , vedere ISCardCmd.

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 informazioni sui codici di errore della smart card, vedere Valori restituiti della smart card.

Esempio

Nell'esempio seguente viene illustrato come recuperare l'unità dati APDU ( Application Protocol) non elaborata. L'esempio presuppone che pISCardCmd sia un puntatore valido all'interfaccia ISCardCmd e che pIByteApdu sia un puntatore valido a un'istanza dell'interfaccia IByteBuffer .

HRESULT    hr;

hr = pISCardCmd->get_Apdu(&pIByteApdu);
if (FAILED(hr)) 
{
    printf("Failed get_Apdu.\n");
    // Take other error handling action as needed.
}

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	Scarddat.h
Libreria dei tipi	Scarddat.tlb
DLL	Scardssp.dll
IID	IID_ISCardCmd è definito come D5778AE3-43DE-11D0-9171-00AA00C18068

Vedi anche

get_ApduLength
ISCardCmd
put_Apdu

Condividi tramite