Condividi tramite


Metodo ISCardCmd::p ut_AlternateClassId

[Il metodo put_AlternateClassId è 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_AlternateClassId specifica un nuovo identificatore di classe alternativo nell'unità dati del protocollo applicazione (APDU).

Sintassi

HRESULT put_AlternateClassId(
  [in] BYTE byClass
);

Parametri

byClass [in]

Identificatore di classe alternativo. Il valore predefinito è zero.

Valore restituito

Il metodo restituisce uno dei valori possibili seguenti.

Codice restituito Descrizione
S_OK
Operazione completata correttamente.
E_INVALIDARG
Il parametro byClass non è valido.

 

Commenti

Con le comunicazioni che usano il protocollo T=0, è possibile generare automaticamente comandi di scheda aggiuntivi dall'APDU e inviare all'unità dati del protocollo di trasmissione (TPDU). I comandi aggiuntivi usano in genere lo stesso ID classe del comando originale; specificando un nuovo ID classe tramite questo metodo, i comandi generati automaticamente possono usare il nuovo ID classe.

Esempio

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

HRESULT  hr;

// Set the class ID.
hr = pISCardCmd->put_AlternateClassId(0xC0);
if (FAILED(hr))
{
  printf("Failed put_AlternateClassId\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-00AA0C18068

Vedi anche

ISCardCmd

get_AlternateClassId