Funzione SCardReconnect (winscard.h)

  • Articolo

La funzione SCardReconnect riestablisa una connessione esistente tra l'applicazione chiamante e una smart card. Questa funzione sposta un handle di scheda dall'accesso diretto all'accesso generale o riconosce e cancella una condizione di errore che impedisce un ulteriore accesso alla scheda.

Sintassi

LONG SCardReconnect(
  [in]            SCARDHANDLE hCard,
  [in]            DWORD       dwShareMode,
  [in]            DWORD       dwPreferredProtocols,
  [in]            DWORD       dwInitialization,
  [out, optional] LPDWORD     pdwActiveProtocol
);

Parametri

[in] hCard

Valore di riferimento ottenuto da una chiamata precedente a SCardConnect.

[in] dwShareMode

Flag che indica se altre applicazioni possono formare connessioni a questa scheda.

Valore Significato
SCARD_SHARE_SHARED
 Questa applicazione condividerà questa scheda con altre applicazioni.
SCARD_SHARE_EXCLUSIVE
 Questa applicazione non condividerà questa scheda con altre applicazioni.

[in] dwPreferredProtocols

Maschera di bit di protocolli accettabili per questa connessione. I valori possibili possono essere combinati con l'operazione OR .

Il valore di questo parametro deve includere il protocollo corrente. Il tentativo di riconnessione con un protocollo diverso dal protocollo corrente genera un errore.

Valore Significato
SCARD_PROTOCOL_T0
 T=0 è un protocollo accettabile.
SCARD_PROTOCOL_T1
 T=1 è un protocollo accettabile.

[in] dwInitialization

Tipo di inizializzazione da eseguire sulla scheda.

Valore Significato
SCARD_LEAVE_CARD
 Non fare nulla di speciale sulla riconnessione.
SCARD_RESET_CARD
 Reimpostare la scheda (reimpostazione calda).
SCARD_UNPOWER_CARD
 Spegnere la scheda e reimpostarla (Reimpostazione a freddo).

[out, optional] pdwActiveProtocol

Flag che indica il protocollo attivo stabilito.

Valore Significato
SCARD_PROTOCOL_T0
 T=0 è il protocollo attivo.
SCARD_PROTOCOL_T1
 T=1 è il protocollo attivo.

Valore restituito

Questa funzione restituisce valori diversi a seconda che abbia esito positivo o negativo.

Codice restituito Descrizione
Success
 SCARD_S_SUCCESS.
Operazioni non riuscite
 Codice di errore. Per altre informazioni, vedere Valori restituiti smart card.

Commenti

SCardReconnect è una funzione di accesso a smart card e lettore . Per informazioni su altre funzioni di accesso, vedere Funzioni di accesso smart card e lettore.

Esempio

Nell'esempio seguente viene illustrata la riestablishing di una connessione.

DWORD     dwAP;
LONG      lReturn;

// Reconnect.
// hCardHandle was set by a previous call to SCardConnect.
lReturn = SCardReconnect(hCardHandle,
                         SCARD_SHARE_SHARED,
                         SCARD_PROTOCOL_T0 | SCARD_PROTOCOL_T1,
                         SCARD_LEAVE_CARD,
                         &dwAP );
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardReconnect\n");

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winscard.h
Libreria Winscard.lib
DLL Winscard.dll

Vedi anche

SCardConnect

SCardDisconnect