Metodo ISCard::Transaction

Articolo
06/13/2023

[Il metodo Transaction è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. I moduli smart card offrono funzionalità simili.

Il metodo Transaction esegue un'operazione di scrittura e lettura sull'oggetto comando smart card (unità dati del protocollo applicazione). La stringa di risposta dalla smart card per la stringa di comando definita nella scheda inviata alla smart card sarà accessibile dopo la restituzione di questa funzione.

Sintassi

HRESULT Transaction(
  [in, out] LPSCARDCMD *ppCmd
);

Parametri

ppCmd [in, out]: Puntatore all'oggetto comando smart card.

Valore restituito

Il metodo restituisce uno dei valori possibili seguenti.

Codice restituito	Descrizione
S_OK	Operazione riuscita.
E_INVALIDARG	Il parametro ppCmd non è valido.
E_POINTER	Un puntatore non valido è stato passato in ppCmd.
E_OUTOFMEMORY	Memoria per soddisfare la richiesta non disponibile.

Commenti

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.

Esempio

Nell'esempio seguente viene illustrata l'esecuzione di un'operazione di scrittura e lettura nell'oggetto comando della smart card.

HRESULT    hr;

// pISCard is a pointer to an instance of ISCard.
// pISCardCmd is a pointer to an instance of ISCardCmd,
// and ISCardCmd::BuildCmd has already been called.
hr = pISCard->Transaction(&pISCardCmd);
if (FAILED(hr))
{
    printf("Failed ISCard::Transaction\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	Scardmgr.h
Libreria dei tipi	Scardmgr.tlb
DLL	Scardssp.dll
IID	IID_ISCard è definito come 1461AAC3-6810-11D0-918F-00AA00C18068

Vedi anche

AttachByHandle
AttachByReader
Scollega
get_Atr
get_CardHandle
get_Context
get_Protocol
get_Status
ISCard
LockSCard
Ricollegare
UnlockSCard

Condividi tramite