Metodo ISCard::ReAttach

Articolo
06/13/2023

[Il metodo ReAttach è 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 ReAttach reimposta o reinizializza la smart card.

Sintassi

HRESULT ReAttach(
  [in] SCARD_SHARE_MODES  ShareMode,
  [in] SCARD_DISPOSITIONS InitState
);

Parametri

ShareMode [in]

Modalità in cui condividere o possedere esclusivamente la connessione alla smart card.

Valore	Significato
ESCLUSIVO	Nessun altro usa questa connessione alla smart card.
CONDIVISO	Altre applicazioni possono usare questa connessione.

InitState [in]

Indica cosa fare con la scheda.

Valore	Significato
LASCIARE	Lascia la smart card nello stato corrente.
RESET	Reimposta lo stato noto della smart card.
UNPOWER	Rimuove l'alimentazione dalla smart card.
ESPELLERE	Espelle 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	C'è qualcosa di sbagliato con uno o più parametri passati alla funzione.

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

Esempio

Nell'esempio seguente viene illustrata la reinizializzazione della smart card.

HRESULT    hr;

// Reattach the smart card.
hr = pISCard->ReAttach(SHARED, LEAVE);
if (FAILED(hr))
{
   printf("Failed ReAttach\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-00AA00C18068

Vedi anche

AttachByHandle
AttachByReader
Scollega
ISCard

Condividi tramite