Metodo ISCard::get_CardHandle
[Il metodo get_CardHandle è 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_CardHandle recupera l'handle per una smart card connessa. Questo metodo restituisce (*pHandle) == NULL se non è connesso.
Sintassi
HRESULT get_CardHandle(
[out] HSCARD *pHandle
);
Parametri
-
pHandle [out]
-
Puntatore all'handle della scheda sul ritorno.
Valore restituito
Il metodo restituisce uno dei valori possibili seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata correttamente. |
|
Il parametro pHandle non è valido. |
|
Un puntatore non valido è stato passato in pHandle. |
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'handle della smart card.
HSCARD hSC;
HRESULT hr;
// Retrieve the card handle.
hr = pISCard->get_CardHandle(&hSC);
if (FAILED(hr))
{
printf("Failed get_CardHandle\n");
// Take other error handling action as needed.
}
// Use card handle 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 |
|
| Libreria dei tipi |
|
| DLL |
|
| IID |
IID_ISCard è definito come 1461AAC3-6810-11D0-918F-00AA0C18068 |
Vedi anche