Metodo ISCard::get_Status
[Il metodo get_Status è 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_Status recupera lo stato corrente della smart card.
Sintassi
HRESULT get_Status(
[out] SCARD_STATES *pStatus
);
Parametri
-
pStatus [out]
-
Puntatore alla variabile di stato.
Valore restituito
Il metodo restituisce uno dei valori possibili seguenti.
Codice restituito | Descrizione |
---|---|
|
Operazione completata correttamente. |
|
Il parametro pStatus non è valido. |
|
Un puntatore non valido è stato passato in pStatus. |
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 dello stato corrente della smart card.
SCARD_STATES scState;
HRESULT hr;
// Determine the current state of the smart card.
hr = pISCard->get_Status(&scState);
if (FAILED(hr))
{
printf("Failed get_Status\n");
exit(1); // Or other error handling action.
}
// Use the retrieved value. (This example merely displays it.)
switch (scState)
{
case ABSENT:
printf("Absent state\n");
break;
case PRESENT:
printf("Present state\n");
break;
case SWALLOWED:
printf("Swallowed state\n");
break;
case POWERED:
printf("Powered state\n");
break;
case NEGOTIABLEMODE:
printf("Negotiable mode state\n");
break;
case SPECIFICMODE:
printf("Specific mode state\n");
break;
default:
printf("Unexpected state\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 |
|
Libreria dei tipi |
|
DLL |
|
IID |
IID_ISCard è definito come 1461AAC3-6810-11D0-918F-00AA0C18068 |
Vedi anche