Funzione SCardForgetReaderA (winscard.h)
La funzione SCardForgetReader rimuove un lettore introdotto in precedenza dal controllo dal sottosistema smart card. Viene rimosso dal database della smart card, incluso da qualsiasi gruppo di lettori a cui potrebbe essere stato aggiunto.
Sintassi
LONG SCardForgetReaderA(
[in] SCARDCONTEXT hContext,
[in] LPCSTR szReaderName
);
Parametri
[in] hContext
Handle che identifica il contesto di Resource Manager. Il contesto di Resource Manager viene impostato da una chiamata precedente a SCardEstablishContext. Questo parametro non può essere NULL.
[in] szReaderName
Nome visualizzato del lettore da rimuovere dal database della smart card.
Valore restituito
Questa funzione restituisce valori diversi a seconda che abbia esito positivo o negativo.
| Codice restituito | Descrizione |
|---|---|
|
SCARD_S_SUCCESS. |
|
Codice di errore. Per altre informazioni, vedere Valori restituiti della smart card. |
Commenti
Se il lettore specificato è l'ultimo membro di un gruppo di lettura, viene rimosso automaticamente anche il gruppo di lettori.
La funzione SCardForgetReader è una funzione di gestione del database. Per altre informazioni su altre funzioni di gestione del database, vedere Funzioni di gestione del database smart card.
Esempio
Nell'esempio seguente viene rimosso il nome visualizzato del lettore di schede specificato dal sistema. L'esempio presuppone che lReturn sia una variabile valida di tipo LONG e che hContext sia un handle valido ricevuto da una chiamata precedente alla funzione SCardEstablishContext .
lReturn = SCardForgetReader(hContext,
TEXT("MyReader"));
if ( SCARD_S_SUCCESS != lReturn )
printf("Failed SCardForgetReader\n");
Nota
L'intestazione winscard.h definisce SCardForgetReader come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| 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 |