Metodo ISCard::get_Protocol

Articolo
06/13/2023

[Il metodo get_Protocol è 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_Protocol recupera l'identificatore del protocollo attualmente in uso nella smart card.

Sintassi

HRESULT get_Protocol(
  [out] SCARD_PROTOCOLS *pProtocol
);

Parametri

pProtocol [out]: Puntatore all'identificatore del protocollo.

Valore restituito

Il metodo restituisce uno dei valori possibili seguenti.

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

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 smart card.

Esempio

Nell'esempio seguente viene illustrato il recupero dell'identificatore del protocollo attualmente in uso nella smart card.

SCARD_PROTOCOLS   scProtocol;
HRESULT           hr;

// Retrieve the protocol.
hr = pISCard->get_Protocol(&scProtocol);
if (FAILED(hr))
{
   printf("Failed get_Protocol\n");
   // Take other error handling action as needed.
}
// Use the retrieved protocol. (This example merely displays it.)
switch (scProtocol)
{
    case T0:
        printf("T0 protocol\n");
        break;
    case T1:
        printf("T1 protocol\n");
        break;
    default:
        printf("Other protocol\n");
        break;
}

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-00AA0C18068

Vedi anche

get_Atr
get_CardHandle
get_Context
get_Status
ISCard

Condividi tramite