Metodo ISCard::UnlockSCard

[Il metodo UnlockScard è 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 UnlockScard rilascia l'accesso esclusivo alla smart card.

Sintassi

HRESULT UnlockSCard(
  [in] SCARD_DISPOSITIONS Disposition
);

Parametri

Eliminazione [in]

Indica cosa deve essere fatto con la scheda nel lettore connesso.

Valore	Significato
LASCIARE	Lascia la smart card nello stato corrente.
RESET	Reimposta la smart card in uno stato noto.
UNPOWER	Rimuove l'alimentazione dalla smart card.
ESPELLERE	Espulse la smart card se il lettore ha funzionalità di espulsione.

 

Valore restituito

Il metodo restituisce uno dei valori possibili seguenti.

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

 

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 rilascio dell'accesso esclusivo alla smart card.

HRESULT    hr;

// Unlock the smart card.
hr = pISCard->UnlockSCard(LEAVE);
if (FAILED(hr))
{
   printf("Failed UnlockSCard\n");
   // Take 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	Scardmgr.h
Libreria dei tipi	Scardmgr.tlb
DLL	Scardssp.dll
IID	IID_ISCard è definito come 1461AAC3-6810-11D0-918F-00AA0C18068

Vedi anche

ISCard

LockSCard