Condividi tramite


Metodo ISCardCmd::p ut_InstructionId

[Il metodo put_InstructionId è 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 put_InstructionId imposta l'identificatore di istruzione specificato nell'unità dati del protocollo applicazione (APDU).

Sintassi

HRESULT put_InstructionId(
  [in] BYTE byIns
);

Parametri

byIns [in]

Byte che è l'identificatore dell'istruzione.

Valore restituito

Il metodo restituisce uno dei valori possibili seguenti.

Codice restituito Descrizione
S_OK
Operazione completata correttamente.
E_INVALIDARG
Il parametro byIns non è valido.
E_OUTOFMEMORY
Memoria insufficiente.

 

Commenti

Per ottenere l'identificatore di istruzione esistente, chiamare get_InstructionId.

Per un elenco di tutti i metodi forniti da questa interfaccia, 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 altre informazioni, vedere Valori restituiti della smart card.

Esempio

Nell'esempio seguente viene illustrato come impostare un identificatore di istruzione nell'unità dati del protocollo dell'applicazione (APDU). L'esempio presuppone che pISCardCmd sia un puntatore valido a un'istanza dell'interfaccia ISCardCmd .

HRESULT hr;

// Set the instruction ID.
hr = pISCardCmd->put_InstructionId(0xb2);
if (FAILED(hr))
{
  printf("Failed put_InstructionId\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_InstructionId

ISCardCmd